> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# List suppliers

> Returns all suppliers for a vendor. Suppliers are referenced in goods receipts and purchase orders.

<ParamField header="x-api-key" type="string" required>
  BOH API key with `catalog:read` scope.
</ParamField>

<ParamField path="vendorId" type="string" required>
  Vendor UUID.
</ParamField>

<ParamField query="limit" type="number">
  Results per page (1–200, default 50).
</ParamField>

<ParamField query="offset" type="number">
  Pagination offset (default 0).
</ParamField>

<ParamField query="include_archived" type="boolean">
  Include archived suppliers. Default `false`.
</ParamField>

<ResponseField name="items" type="object[]">
  Array of supplier objects: `id`, `account_id`, `external_supplier_id`, `code`, `name`, `email`, `phone`, `tax_id`, `is_active`, `created_at`, `updated_at`.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "sup_01j5k...",
        "account_id": "acc_01j5k...",
        "external_supplier_id": "SUP-001",
        "code": "BEST-FOODS",
        "name": "Best Foods Co.",
        "email": "orders@bestfoods.com",
        "phone": "+1-555-000-0001",
        "tax_id": "12-3456789",
        "is_active": true,
        "created_at": "2026-01-01T00:00:00.000Z",
        "updated_at": "2026-01-01T00:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
  ```
</ResponseExample>