---
title: "Listar opções"
description: "GET /v1/catalog/options — opções dos grupos da empresa BeeFood, com filtros e paginação."
method: "GET"
path: "/v1/catalog/options"
url: "https://developer.beefood.com.br/docs/catalogo/opcoes"
group: "Catálogo"
scope: "catalog:read"
lang: "pt"
---
# Listar opções

`GET /v1/catalog/options`

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

Lista as opções 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`.

- `groupId` *integer* — Filtra as opções pertencentes a determinado grupo. Exemplo: `264428`.

- `name` *string* — Filtra pelo nome da opção. Exemplo: `onion`.

- `type` *string* — Filtra pelo tipo: product ou complement. Exemplo: `product`.

- `active` *boolean* — Filtra opções ativas ou inativas. Exemplo: `true`.

- `delivery` *boolean* — Filtra opções do delivery. Exemplo: `true`.

- `dineIn` *boolean* — Filtra opções do presencial. Exemplo: `true`.




## Exemplos de requisição

### cURL

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


## Exemplos de resposta

### 200 OK

```json
{
  "items": [
    {
      "groupId": 264428,
      "optionId": 5689346,
      "productId": 2586945,
      "name": "Onion rings",
      "type": "product",
      "active": true,
      "delivery": true,
      "dineIn": true,
      "minQuantity": 1,
      "maxQuantity": 1,
      "price": 5.5,
      "sortOrder": 1,
      "image": {
        "original": "https://cdn.beefood.com.br/products/2586945.jpg",
        "thumbnail60": "https://cdn.beefood.com.br/products/2586945_60.jpg",
        "thumbnail120": "https://cdn.beefood.com.br/products/2586945_120.jpg",
        "thumbnailWeb": "https://cdn.beefood.com.br/products/2586945_web.jpg"
      }
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "pages": 1
}
```


## Campos da resposta

- `items[].groupId` *number* — Identificador do grupo.

- `items[].optionId` *number* — Identificador da opção.

- `items[].productId` *number* — Identificador do produto ou complemento.

- `items[].name` *string* — Nome da opção.

- `items[].type` *string* — Tipo da opção: product ou complement.

- `items[].active` *boolean* — Indica se a opção está ativa.

- `items[].delivery` *boolean* — Indica se a opção aparece no delivery.

- `items[].dineIn` *boolean* — Indica se a opção aparece no presencial.

- `items[].minQuantity` *number* — Quantidade mínima.

- `items[].maxQuantity` *number* — Quantidade máxima.

- `items[].price` *number* — Preço da opção.

- `items[].deliveryPrice` *number* — Preço no delivery.

- `items[].dineInPrice` *number* — Preço no presencial.

- `items[].sortOrder` *number* — Posição da opção no grupo.

- `items[].image` *object* — URLs da imagem do produto.

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

- `items[].image.thumbnail60` *string* — Miniatura de 60 px.

- `items[].image.thumbnail120` *string* — Miniatura de 120 px.

- `items[].image.thumbnailWeb` *string* — Miniatura para web.

- `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 |
| 400 | Invalid type |
| 404 | Group ID 264428 not found |