GET Contar Orçamentos
Retorna a quantidade de orçamentos da conta em um período, com filtro opcional por status de envio para fila.
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 read_budgets.
Endpoint
GET https://api-dev.imagemais.com.br/api/budgets/count
Parâmetros de Query
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
dateInitial | string | ✅ | Data inicial do período (YYYY-MM-DD, por updatedAt) |
dateFinal | string | ✅ | Data final do período (YYYY-MM-DD, por updatedAt) |
sendToQueue | string (boolean) | ❌ | 1 = enviado para fila / 0 = não enviado |
search | string | ❌ | Busca pelo paciente (mesma regra de Listar Orçamentos) |
createUserId | number | ❌ | Filtra pelo ID do usuário que criou o orçamento |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/budgets/count?dateInitial=2026-01-01&dateFinal=2026-01-31&sendToQueue=1' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
{
"count": 42
}
400 Bad Request
Retornado quando dateInitial ou dateFinal não são enviados.
{
"message": [
"dateInitial must be a string",
"dateFinal must be a string"
],
"error": "Bad Request",
"statusCode": 400
}