---
title: "Listar merchants"
description: "GET /v1/store/merchants — listagem paginada dos cardápios (merchants) do restaurante na API BeeFood."
method: "GET"
path: "/v1/store/merchants"
url: "https://developer.beefood.com.br/docs/loja/merchants"
group: "Restaurante"
scope: "store:read"
lang: "pt"
---
# Listar merchants

`GET /v1/store/merchants`

- Produção: `https://api.beefood.app/v1/store/merchants`
- Sandbox: `https://api-sandbox.beefood.app/v1/store/merchants`

Lista as filiais ativas do restaurante (matriz e demais), com ou sem cardápio de delivery.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `store:read`. Limite: 15 requisições por minuto.



## Parâmetros de query

- `page` *integer* — Página atual da lista. Exemplo: `1`.

- `limit` *integer* — Quantidade de itens por página. Exemplo: `20`.

- `sort` *string* — Ordem da lista: mais recentes (desc) ou mais antigos (asc). Exemplo: `"desc"`.
  - *Valores:* `asc`, `desc`

- `main` *boolean* — Filtra a matriz (true) ou os demais cardápios (false). Ausente = todos. Exemplo: `true`.

- `city` *string* — Filtra pela cidade do cardápio. Exemplo: `"São Paulo"`.

- `state` *string* — Filtra pelo estado (UF) do cardápio. Exemplo: `"SP"`.




## Exemplos de requisição

### cURL

```bash
curl -X GET "https://api.beefood.app/v1/store/merchants?page=1&limit=20&sort=desc" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


## Exemplos de resposta

### 200 OK

```json
{
  "items": [
    {
      "storeId": 38311,
      "merchantId": 50502,
      "tradeName": "Restaurante Exemplo - Sushi",
      "main": false
    },
    {
      "storeId": 38311,
      "merchantId": 39202,
      "tradeName": "Restaurante Exemplo",
      "main": true,
      "city": "Sorocaba",
      "state": "SP"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 2,
  "pages": 1
}
```


## Campos da resposta

- `items[].storeId` *number* — ID do restaurante.

- `items[].merchantId` *number* — ID do cardápio.

- `items[].tradeName` *string* — Nome fantasia do cardápio.

- `items[].main` *boolean* — Indica se é o cardápio principal.

- `items[].city` *string* — Cidade.

- `items[].state` *string* — UF.

- `page` *number* — Página atual da lista.

- `limit` *number* — Quantidade de itens por página.

- `total` *number* — Total de registros encontrados.

- `pages` *number* — Total de páginas.



## Erros

| Status | Mensagem |
| --- | --- |
| 400 | 'page' must be an integer >= 1 |
| 400 | 'limit' must be an integer between 1 and 100 |
| 400 | 'sort' must be asc or desc |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the store:read scope |
| 500 | Database error when trying to … |


## Vocabulários usados neste endpoint

## Listagens · sort

| Valor | Significado | Uso |
| --- | --- | --- |
| `asc` | Crescente | Todas as listagens |
| `desc` | Decrescente (padrão) | Todas as listagens |