GET/api/budgets/count

Contar Orçamentos

Retorna a contagem total de orçamentos baseada nos filtros aplicados. Permite contar orçamentos por intervalo de datas e controle de envio para fila. Útil para obter estatísticas e métricas sem precisar carregar todos os dados dos orçamentos.

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}

Parâmetros

dateInitialOBRIGATÓRIO
Tipo:string
Data inicial da busca (formato: YYYY-MM-DD)

Este parâmetro define o intervalo de datas para a busca de orçamentos. Especifica a data inicial do período.

Formato:

?dateInitial=2025-12-01

Atenção: Se a data inicial ou a data final não estiverem no sistema, forem inválidas ou não condizentes (por exemplo, datas futuras muito distantes ou períodos sem orçamentos), a API retornará count: 0. Certifique-se de usar datas válidas no formato YYYY-MM-DD e que correspondam a períodos onde existam orçamentos cadastrados.

dateFinalOBRIGATÓRIO
Tipo:string
Data final da busca (formato: YYYY-MM-DD)

Este parâmetro define o intervalo de datas para a busca de orçamentos. Especifica a data final do período.

Formato:

?dateFinal=2025-12-01

Atenção: Se a data inicial ou a data final não estiverem no sistema, forem inválidas ou não condizentes (por exemplo, datas futuras muito distantes ou períodos sem orçamentos), a API retornará count: 0. Certifique-se de usar datas válidas no formato YYYY-MM-DD e que correspondam a períodos onde existam orçamentos cadastrados.

Request URL

https://api-dev.imagemais.com/api/budgets/count?dateInitial=2025%2F12%2F01&dateFinal=2025%2F12%2F03&sendToQueue=0

Respostas

{
  "count": 100
}
{
  "count": 100
}
{
  "count": 0
}
{
  "count": 0
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}