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

# Get a supplier

> Returns a single supplier with full detail including metadata.

<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 path="supplierId" type="string" required>
  Supplier UUID.
</ParamField>

<ResponseField name="id" type="string">Supplier UUID.</ResponseField>
<ResponseField name="account_id" type="string">Account UUID.</ResponseField>
<ResponseField name="external_supplier_id" type="string">Your system's supplier identifier.</ResponseField>
<ResponseField name="code" type="string">Short alphanumeric code.</ResponseField>
<ResponseField name="name" type="string">Display name.</ResponseField>
<ResponseField name="email" type="string">Contact email.</ResponseField>
<ResponseField name="phone" type="string">Contact phone.</ResponseField>
<ResponseField name="tax_id" type="string">Tax/fiscal identifier.</ResponseField>
<ResponseField name="is_active" type="boolean">`false` when archived.</ResponseField>
<ResponseField name="metadata" type="object">Free-form extra data.</ResponseField>
<ResponseField name="created_at" type="string">ISO 8601 creation timestamp.</ResponseField>
<ResponseField name="updated_at" type="string">ISO 8601 last-update timestamp.</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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,
    "metadata": {},
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "kind": "supplier_not_found",
      "message": "Supplier not found"
    }
  }
  ```
</ResponseExample>