---
title: "Listar avaliações"
description: "GET /v1/store/reviews — avaliações do restaurante na API BeeFood."
method: "GET"
path: "/v1/store/reviews"
url: "https://developer.beefood.com.br/docs/loja/avaliacoes"
group: "Restaurante"
scope: "reviews:read"
lang: "pt"
---
# Listar avaliações

`GET /v1/store/reviews`

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

Retorna as avaliações da empresa.

## Autenticação

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



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

- `merchantId` *integer* — Filtra por cardápio. Exemplo: `39202`.

- `createdAtFrom` *string (yyyy-mm-dd)* — Início do período, o dia inicial é incluído. Pode ser enviado sozinho. Exemplo: `"2026-10-01"`.

- `createdAtTo` *string (yyyy-mm-dd)* — Fim do período; o dia final é incluído. Pode ser enviado sozinho e não pode ser menor que createdAtFrom. Exemplo: `"2026-10-09"`.




## Exemplos de requisição

### cURL

```bash
curl -X GET "https://api.beefood.app/v1/store/reviews?createdAtFrom=2026-10-01&createdAtTo=2026-10-09&page=1&limit=20&sort=desc" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


## Exemplos de resposta

### Uma nota preenchida

```json
{
  "items": [
    {
      "reviewId": 670978,
      "storeId": 38311,
      "merchantId": 39202,
      "customerId": 1001,
      "consumerId": 2001,
      "orderId": 123,
      "name": "Cliente Exemplo",
      "phone": "11999990000",
      "comment": "Muito bom",
      "averageRating": 5,
      "origin": "DIGITAL_MENU_DELIVERY",
      "published": false,
      "createdAt": "2026-08-31T10:11:26.450Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "pages": 1
}
```

### Duas notas preenchidas

```json
{
  "items": [
    {
      "reviewId": 670979,
      "storeId": 38311,
      "merchantId": 39202,
      "name": "Cliente Exemplo",
      "comment": "Comida boa, demorou um pouco",
      "averageRating": 4.5,
      "origin": "TABLE",
      "published": true,
      "createdAt": "2026-09-01T20:42:10.000Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "pages": 1
}
```

### Três notas, com arredondamento

```json
{
  "items": [
    {
      "reviewId": 670980,
      "storeId": 38311,
      "merchantId": 39202,
      "averageRating": 4.3,
      "origin": "DELIVERY",
      "published": true,
      "createdAt": "2026-09-02T19:05:00.000Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "pages": 1
}
```

### Avaliação sem nota

```json
{
  "items": [
    {
      "reviewId": 670981,
      "storeId": 38311,
      "merchantId": 39202,
      "comment": "Já pedi outras vezes",
      "origin": "DELIVERY",
      "published": false,
      "createdAt": "2026-09-03T12:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "pages": 1
}
```


## Campos da resposta

- `items[].reviewId` *number* — ID da avaliação.

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

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

- `items[].customerId` *number* — ID do cliente.

- `items[].consumerId` *number* — ID do consumidor.

- `items[].orderId` *number* — ID do pedido avaliado.

- `items[].name` *string* — Nome de quem avaliou.

- `items[].phone` *string* — Telefone informado.

- `items[].comment` *string* — Comentário escrito.

- `items[].averageRating` *number* — Média das notas preenchidas, de 0 a 5, arredondada a uma casa decimal. Omitida quando não há notas. Exemplo: `4.3`.

- `items[].howDidYouHear` *string* — Como conheceu o restaurante.

- `items[].origin` *string* — Canal de origem da avaliação.
  - *Valores:* `DIGITAL_MENU_DELIVERY`, `DIGITAL_MENU_LOCAL`, `DELIVERY`, `TABLE`, `OTHER`

- `items[].published` *boolean* — Indica se a avaliação está publicada.

- `items[].createdAt` *string (ISO 8601)* — Quando a avaliação foi feita.

- `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 |
| 400 | 'createdAtFrom' must be a date (yyyy-mm-dd) |
| 400 | 'createdAtTo' must be a date (yyyy-mm-dd) |
| 400 | 'createdAtFrom' must be <= 'createdAtTo' |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the reviews:read scope |
| 404 | Merchant ID 99 not found |
| 500 | Database error when trying to … |


## Vocabulários usados neste endpoint

## Avaliações · origin

| Valor | Significado | Uso |
| --- | --- | --- |
| `DIGITAL_MENU_DELIVERY` | Cardápio digital delivery | GET /v1/store/reviews |
| `DIGITAL_MENU_LOCAL` | Cardápio digital presencial | GET /v1/store/reviews |
| `DELIVERY` | Delivery | GET /v1/store/reviews |
| `TABLE` | Mesa / comanda | GET /v1/store/reviews |
| `OTHER` | Outro | GET /v1/store/reviews |

## Listagens · sort

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