GET /api/suppliers

Request	`GET /api/suppliers`
Authentication	Session cookie required
Handler	`backend/server.py`

What it does

Suppliers for a query. With no question it refuses by name and says what to do instead — name a product to source, or claim one first — rather than returning an empty list that reads as 'none exist'.

Authentication

Session cookie required. Send the ff_session cookie. Without one the engine treats the caller as a new visitor with no holds and no claims, and returns a new cookie to use from then on.

Parameters

Parameter	In	Type	Required	Description
`ff_session`	cookie	`string`	Optional	The session identifier. Omit it on the first call and store the value the response sets; every later call must send the same one or the engine treats the caller as a new visitor with no holds and no claims.
`q`	query	`string`	Optional	The product to source. Absent produces `refused` / `no_question`.

Request

The cookie jar carries the session between calls. Angle-bracketed values are the parameter types from the table above.

cURLJavaScriptPython

curl -s -b cookies.txt -c cookies.txt \
  "https://flowfinds.ai/api/suppliers"

const res = await fetch("https://flowfinds.ai/api/suppliers", {
  method: "GET",
  credentials: "include",
});
const data = await res.json();

import requests

s = requests.Session()
r = s.get("https://flowfinds.ai/api/suppliers")
data = r.json()

Recorded example

curl -s -b cookies.txt -c cookies.txt \
  "$FLOWFINDS_ORIGIN/api/suppliers?q=…"

Responses

`200` — Suppliers were found.

`200` — No question was asked.

Field	Type	Description
`status`	`string`	`refused`.
`reason`	`string`	`no_question`.
`explanation`	`string`	'Name a product to source, or claim one first.'
`suppliers`	`array`	Empty.

Errors

This endpoint has no failure path of its own. An uncaught exception anywhere in the engine is still returned as structured JSON by the shared guard.

GET /api/supplier-connection — Which supplier this account is connected to.
POST /api/supplier-connection — Connect or disconnect a supplier.
POST /api/samples/checkout — Order a physical sample of a product.

Back to the API reference index, or read the cookbook for recipes that compose this endpoint with others.