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

# Listar artículos

> Devuelve todos los artículos de catálogo para un vendor con filtros opcionales de paginación y estado.

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

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

<ParamField query="limit" type="number">Resultados por página (1–200, default 50).</ParamField>
<ParamField query="offset" type="number">Offset de paginación (default 0).</ParamField>
<ParamField query="status" type="string">Filtrar por `ACTIVE` o `INACTIVE`.</ParamField>

<ResponseField name="items" type="object[]">
  Array de artículos de catálogo: `id`, `account_id`, `name`, `status`, `base_unit_id`, `unit_group_id`, `external_item_id`, `metadata`, `created_at`, `updated_at`.
</ResponseField>

<ResponseField name="total" type="number">Total de registros.</ResponseField>
<ResponseField name="limit" type="number">Tamaño de página.</ResponseField>
<ResponseField name="offset" type="number">Offset actual.</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "itm_01...",
        "account_id": "acc_01j5k...",
        "name": "Tomate Bola",
        "status": "ACTIVE",
        "base_unit_id": "unit_kg_01...",
        "unit_group_id": "ug_peso_01...",
        "external_item_id": "tomate-bola",
        "metadata": {},
        "created_at": "2026-01-01T00:00:00.000Z",
        "updated_at": "2026-01-01T00:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
  ```
</ResponseExample>