KintsugiKintsugi
API reference / List fulfil companies

List fulfil companies

POST/connections/fulfil/companies

List Fulfil companies for a merchant and personal access token. The token is in the body because no connection is stored yet. Returns 400 if the merchant or token is rejected, and 503 if Fulfil cannot be reached.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

merchantstringRequired

Fulfil merchant subdomain, or a fulfil.io host.

apiKeystringRequired

Fulfil personal access token.

Response

companiesFulfilCompany[]

Companies available under the token.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

422

The request failed validation.

503

A service this request depends on was unavailable. Retry the request.

cURL
POST /connections/fulfil/companies
-H "Api-Key: ***"
-H "Api-Version: 2026-10-06"
{
"merchant": "acme",
"apiKey": "********"
}
Response
{
"companies": [
{
"id": "1",
"name": "[A1] Apple Inc."
}
]
}
List fulfil companies (2026-10-06) | Kintsugi API Reference