---
title: "Listar setores"
description: "GET /v1/catalog/sectors — setores do cardápio da empresa BeeFood, com filtros e paginação."
method: "GET"
path: "/v1/catalog/sectors"
url: "https://developer.beefood.com.br/docs/catalogo/setores"
group: "Catálogo"
scope: "catalog:read"
lang: "pt"
---
# Listar setores

`GET /v1/catalog/sectors`

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

Lista os setores da empresa.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `catalog:read`. Limite: 300 requisições a cada 3 minutos.



## Parâmetros de query

- `page` *integer* — Página (padrão 1). Exemplo: `1`.

- `limit` *integer* — Itens por página, de 1 a 100 (padrão 20). Exemplo: `20`.

- `sort` *string* — Ordem por sectorId: asc ou desc (padrão desc). Exemplo: `desc`.
  - *Valores:* `asc`, `desc`

- `name` *string* — Filtra pelo nome do setor. Exemplo: `Sobremesas`.

- `active` *boolean* — true: ativo em ao menos um cardápio; false: inativo em todos. Exemplo: `true`.

- `delivery` *boolean* — Filtra setores ativos para delivery. Exemplo: `true`.

- `dineIn` *boolean* — Filtra setores ativos para presencial. Exemplo: `true`.




## Exemplos de requisição

### cURL

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


## Exemplos de resposta

### 200 OK

```json
{
  "items": [
    {
      "sectorId": 221145,
      "storeId": 107,
      "name": "Campanhas de Desconto",
      "publicName": "Campanhas",
      "delivery": true,
      "dineIn": true,
      "image": {
        "original": "https://beetech-imagens.s3-sa-east-1.amazonaws.com/107/001308e84.jpg",
        "thumbnail80": "https://beetech-imagens.beefood-r2.work/107/s/80/001308e84.jpg",
        "thumbnail180": "https://beetech-imagens.beefood-r2.work/107/s/180/001308e84.jpg"
      },
      "menus": [
        {
          "merchantId": 122,
          "name": "Restaurante Exemplo",
          "active": true,
          "sortOrder": 1
        }
      ]
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "pages": 1
}
```


## Campos da resposta

- `items[].sectorId` *number* — Identificador do setor.

- `items[].storeId` *number* — Identificador da empresa.

- `items[].name` *string* — Nome do setor.

- `items[].publicName` *string* — Nome exibido no cardápio digital.

- `items[].delivery` *boolean* — Indica se o setor aparece no delivery.

- `items[].dineIn` *boolean* — Indica se o setor aparece no presencial.

- `items[].image` *object* — URLs da imagem do setor. Somente leitura. Para enviar ou remover, use Enviar imagem e Remover imagem com resourceType = sectors.

- `items[].image.original` *string* — Imagem original.

- `items[].image.thumbnail80` *string* — Miniatura de 80 px.

- `items[].image.thumbnail180` *string* — Miniatura de 180 px.

- `items[].menus` *array* — Cardápios do setor.

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

- `items[].menus[].name` *string* — Nome do cardápio.

- `items[].menus[].active` *boolean* — Indica se o setor está ativo no cardápio.

- `items[].menus[].sortOrder` *number* — Posição do setor no cardápio.

- `page` *number* — page da paginação.

- `limit` *number* — limit da paginação.

- `total` *number* — total da paginação.

- `pages` *number* — pages da paginação.



## Erros

| Status | Mensagem |
| --- | --- |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the catalog:read scope |
| 429 | Too many requests |


## Vocabulários usados neste endpoint

## Listagens · sort

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