REST API / Suppliers

Suppliers

The suppliers trading on the platform. Every one of them is open to order from — there is no connection to establish first.

GET/v1/suppliers

List suppliers

Returns every supplier trading on the platform. There is no connection step: any supplier listed here is one you can order from. `can_accept_orders` reflects the supplier's current Stripe payout status — POST /orders is rejected with 403 for any supplier where this is false.

Response

200 OK

{
  "data": [
    {
      "id": "5f50e19c-09a0-4b45-8a96-4a9b53a97641",
      "company_name": "EcoThreads Ltd",
      "contact_email": "trade@ecothreads.co.uk",
      "website_url": "https://ecothreads.co.uk",
      "country": "GB",
      "can_accept_orders": true
    }
  ]
}

GET/v1/suppliers/{id}

Get supplier

Returns detail for a single trading supplier.

Path parameters

iduuid

required

Supplier UUID

Response

200 OK

{
  "data": {
    "id": "5f50e19c-09a0-4b45-8a96-4a9b53a97641",
    "company_name": "EcoThreads Ltd",
    "contact_email": "trade@ecothreads.co.uk",
    "website_url": "https://ecothreads.co.uk",
    "country": "GB",
    "can_accept_orders": true
  }
}

Error responses

404

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Supplier not found",
    "status": 404
  }
}