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

> Retorna todos os estabelecimentos (localizações físicas) do vendor com filtros opcionais.

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

<ParamField path="vendorId" type="string" required>UUID do vendor.</ParamField>
<ParamField query="limit" type="number">Resultados por página (1–200, padrão 50).</ParamField>
<ParamField query="offset" type="number">Offset de paginação (padrão 0).</ParamField>
<ParamField query="status" type="string">Filtrar por `ACTIVE` ou `INACTIVE`.</ParamField>

<ResponseField name="items" type="object[]">Array de objetos de estabelecimento.</ResponseField>
<ResponseField name="total" type="number">Total de registros.</ResponseField>
<ResponseField name="limit" type="number">Tamanho de página atual.</ResponseField>
<ResponseField name="offset" type="number">Offset atual.</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "str_principal_01...",
        "account_id": "acc_01j5k...",
        "code": "EST-001",
        "name": "Cozinha Principal",
        "timezone": "America/Sao_Paulo",
        "status": "ACTIVE",
        "external_store_id": "loja-principal",
        "tax_id": "12.345.678/0001-90"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
  ```
</ResponseExample>