GET Contar Pedidos por Status
Contagem de pedidos por status. Devolve os quatro status numa resposta só, para as abas da fila. O período recorta apenas finalizados e cancelados: aguardando e em coleta são a fila do momento, e contá-los por data diria "nenhum" para quem espera desde ontem.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão collect_laboratory.
Endpoint
GET https://api-dev.imagemais.com.br/api/orders/status-counts
Parâmetros de Query
| Nome | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
dateInitial | string | ✅ | data ISO 8601 | Data inicial (YYYY-MM-DD) |
dateFinal | string | ✅ | data ISO 8601 | Data final (YYYY-MM-DD) |
acceptUserId | string | ❌ | — | Filtra pelo usuário que aceitou o pedido |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/orders/status-counts?dateInitial=2026-09-01&dateFinal=2026-09-30' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
Retorna a quantidade de pedidos no período, por status, nas chaves STANDBY, IN_PROGRESS, COMPLETED e CANCELED.
{
"STANDBY": 9,
"IN_PROGRESS": 1,
"COMPLETED": 2,
"CANCELED": 0
}
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"dateInitial deve ser uma data no formato AAAA-MM-DD"
],
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}