Skip to main content

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​

NomeTipoObrigatórioDescrição
dateInitialstring✅Data inicial do período (YYYY-MM-DD, por updatedAt)
dateFinalstring✅Data final do período (YYYY-MM-DD, por updatedAt)
sendToQueuestring (boolean)❌1 = enviado para fila / 0 = não enviado
searchstring❌Busca pelo paciente (mesma regra de Listar Orçamentos)
createUserIdnumber❌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
}