---
title: "Polling de pedidos"
description: "GET /v1/orders/polling — polling leve dos pedidos das últimas 8h na fila de eventos da API BeeFood."
method: "GET"
path: "/v1/orders/polling"
url: "https://developer.beefood.com.br/docs/pedidos/polling"
group: "Pedidos"
scope: "orders:read"
lang: "pt"
---
# Polling de pedidos

`GET /v1/orders/polling`

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

Retorna o último evento de cada pedido com eventos nas últimas 8 horas.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `orders:read`. Limite: 15 requisições a cada 5 minutos; recomendado a cada 30 segundos.



## Parâmetros de query

- `updatedSince` *string (ISO 8601)* — Só eventos a partir desta data/hora (até 24h). Exemplo: `"2025-03-15T18:00:00.000-03:00"`.

- `events` *string | string[]* — Filtra pelos tipos de evento desejados. Exemplo: `"order_updated"`.
  - *Valores:* `order_created`, `order_updated`, `order_delivery_updated`, `payment_created`, `payment_updated`




## Exemplos de requisição

### cURL

```bash
curl -X GET "https://api.beefood.app/v1/orders/polling" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


## Exemplos de resposta

### 200 OK

```json
[
  {
    "orderId": 58449271,
    "event": "order_created",
    "orderType": "DELIVERY",
    "salesChannel": "MANUAL",
    "orderStatusDelivery": "WAITING",
    "createdAt": "2025-03-15T16:27:48.000-03:00"
  },
  {
    "orderId": 58449215,
    "event": "order_updated",
    "orderType": "DELIVERY",
    "salesChannel": "DIGITAL_MENU",
    "orderStatusDelivery": "ACCEPTED",
    "createdAt": "2025-03-15T16:03:13.000-03:00"
  },
  {
    "orderId": 58449271,
    "event": "order_delivery_updated",
    "orderType": "DELIVERY",
    "salesChannel": "MANUAL",
    "orderStatusDelivery": "PREPARING",
    "createdAt": "2025-03-15T16:27:48.000-03:00"
  },
  {
    "orderId": 58449280,
    "event": "payment_created",
    "orderType": "PDV",
    "salesChannel": "TOTEM",
    "orderStatusDelivery": "READY",
    "createdAt": "2025-03-15T15:40:00.000-03:00"
  },
  {
    "orderId": 58449281,
    "event": "payment_updated",
    "orderType": "TABLE",
    "salesChannel": "IFOOD",
    "orderStatusDelivery": "DISPATCHED",
    "createdAt": "2025-03-15T15:20:00.000-03:00"
  },
  {
    "orderId": 58449271,
    "event": "order_delivery_updated",
    "orderType": "DELIVERY",
    "salesChannel": "MANUAL",
    "orderStatusDelivery": "DELIVERED",
    "createdAt": "2025-03-15T16:32:13.000-03:00"
  },
  {
    "orderId": 58449282,
    "event": "order_updated",
    "orderType": "DELIVERY",
    "salesChannel": "DIGITAL_MENU",
    "orderStatusDelivery": "CANCELLED",
    "createdAt": "2025-03-15T14:10:00.000-03:00"
  }
]
```


## Campos da resposta

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

- `[].event` *string* — Último evento ocorrido no pedido.
  - *Valores:* `order_created`, `order_updated`, `order_delivery_updated`, `payment_created`, `payment_updated`

- `[].orderType` *string* — Tipo do pedido.
  - *Valores:* `DELIVERY`, `PDV`, `TABLE`

- `[].salesChannel` *string* — Canal de venda do pedido.
  - *Valores:* `IFOOD`, `99FOOD`, `KEETA`, `AIQFOME`, `RAPPI`, `DELIVERYMUCH`, `UAIRANGO`, `TOTEM`, `EXTERNAL`, `WHATSAPP`, `DIGITAL_MENU`, `MANUAL`

- `[].orderStatusDelivery` *string* — Situação da entrega no momento do evento.
  - *Valores:* `WAITING`, `ACCEPTED`, `PREPARING`, `READY`, `DISPATCHED`, `DELIVERED`, `CANCELLED`

- `[].createdAt` *string (ISO 8601)* — Quando o pedido foi criado.



## Erros

| Status | Mensagem |
| --- | --- |
| 400 | 'updatedSince' must be a valid date-time |
| 400 | 'updatedSince' must be within the last 24 hours |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the orders:read scope |
| 429 | Too Many Requests |
| 500 | Database error when trying to … |


## Vocabulários usados neste endpoint

## Pedidos · deliveryStatus

Situação operacional do pedido. Aparece na lista e no detalhe e é espelhada nos webhooks de status.

| Valor | Significado | Uso |
| --- | --- | --- |
| `WAITING` | Aguardando | Pedidos e webhooks |
| `ACCEPTED` | Aceito | Pedidos e webhooks |
| `PREPARING` | Em preparo | Pedidos e webhooks |
| `READY` | Pronto | Pedidos e webhooks |
| `DISPATCHED` | Despachado | Pedidos e webhooks |
| `DELIVERED` | Entregue | Pedidos e webhooks |
| `CANCELLED` | Cancelado | Pedidos e webhooks |

## Pedidos · orderType

Outros literais vindos do PDV podem aparecer sem tradução.

| Valor | Significado | Uso |
| --- | --- | --- |
| `DELIVERY` | Pedido delivery | Detalhe do pedido |
| `PDV` | Pedido lançado no PDV | Detalhe do pedido |
| `TABLE` | Mesa / presencial | Detalhe do pedido |

## Pedidos · salesChannel

| Valor | Significado | Uso |
| --- | --- | --- |
| `IFOOD` | iFood | Detalhe, listagem (filtro), polling e webhooks |
| `99FOOD` | 99Food | Detalhe, listagem (filtro), polling e webhooks |
| `KEETA` | Keeta | Detalhe, listagem (filtro), polling e webhooks |
| `AIQFOME` | Aiqfome | Detalhe, listagem (filtro), polling e webhooks |
| `RAPPI` | Rappi | Detalhe, listagem (filtro), polling e webhooks |
| `DELIVERYMUCH` | Delivery Much | Detalhe, listagem (filtro), polling e webhooks |
| `UAIRANGO` | UaiRango | Detalhe, listagem (filtro), polling e webhooks |
| `TOTEM` | Totem | Detalhe, listagem (filtro), polling e webhooks |
| `EXTERNAL` | Integração externa | Detalhe, listagem (filtro), polling e webhooks |
| `WHATSAPP` | Cardápio digital via WhatsApp | Detalhe, listagem (filtro), polling e webhooks |
| `DIGITAL_MENU` | Cardápio digital | Detalhe, listagem (filtro), polling e webhooks |
| `MANUAL` | Lançamento manual / PDV | Detalhe, listagem (filtro), polling e webhooks |

## Polling · event

| Valor | Significado | Uso |
| --- | --- | --- |
| `order_created` | Pedido criado | GET /v1/orders/polling |
| `order_updated` | Pedido atualizado | GET /v1/orders/polling |
| `order_delivery_updated` | Entrega do pedido atualizada | GET /v1/orders/polling |
| `payment_created` | Pagamento criado | GET /v1/orders/polling |
| `payment_updated` | Pagamento atualizado | GET /v1/orders/polling |