> ## 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 vendors

> Returns all vendors for your account. Use this to discover vendor IDs required for all other API calls.

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

<ResponseField name="vendors" type="object[]">
  Array of vendor objects: `id`, `account_id`, `external_vendor_id`, `name`, `status`, `metadata`, `created_at`, `updated_at`.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "vendors": [
      {
        "id": "vnd_01j5k...",
        "account_id": "acc_01j5k...",
        "external_vendor_id": "brand-main",
        "name": "My Restaurant Brand",
        "status": "ACTIVE",
        "metadata": {},
        "created_at": "2026-01-01T00:00:00.000Z",
        "updated_at": "2026-01-01T00:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>