Skip to main content

GET Painel de Exames Pedidos

Números do painel de acompanhamento de exames pedidos: pacientes para ligar, exames aguardando por prazo, tempo até fazer, por onde foi feito e exames que mais vencem.

Exame feito = mesmo paciente e procedimento em pedido de laboratório ou agendamento finalizado, em até 45 dias do pedido. Passados os 45 dias sem realização, o pedido está vencido. Exames digitados fora do catálogo não podem ser acompanhados (untracked).

Os dados vêm do ClickHouse: sem ele, a rota responde 503.

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_reports.

Fila de hoje × período

Os campos da fila de hoje (patientsToCall, pending, expiredLast30Days, pendingByDeadline, pendingByDoctor) ignoram o período e refletem o estado atual. Os demais valem para os pedidos feitos dentro de from–to.


Endpoint​

GET https://api-dev.imagemais.com.br/api/exam-tracking/dashboard

Parâmetros de Query​

NomeTipoObrigatórioValores válidosDescrição
fromstring✅data ISO 8601 (YYYY-MM-DD)Pedidos feitos a partir deste dia
tostring✅data ISO 8601 (YYYY-MM-DD); não anterior a fromPedidos feitos até este dia, inclusive
doctorIdstring❌até 50 ids inteiros positivos, separados por vírgula (1,2) ou repetidos (doctorId=1&doctorId=2)Médicos da consulta

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/exam-tracking/dashboard?from=2026-10-01&to=2026-10-31&doctorId=1,2' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"patientsToCall": 14,
"pending": 21,
"expiredLast30Days": 9,
"pendingByDoctor": [
{
"id": 12,
"name": "Nome Exemplo",
"pending": 8
},
{
"id": 0,
"name": "Sem médico",
"pending": 2
}
],
"performed": 63,
"medianDaysToPerform": 6,
"performedByOrder": 41,
"performedByAppointment": 22,
"pendingByDeadline": [
{
"label": "Até 7 dias",
"exams": 5,
"patients": 4
},
{
"label": "8 a 15 dias",
"exams": 6,
"patients": 5
},
{
"label": "16 a 30 dias",
"exams": 7,
"patients": 6
},
{
"label": "31 a 45 dias",
"exams": 3,
"patients": 3
}
],
"timeToPerform": [
{
"label": "Até 3 dias",
"exams": 18
},
{
"label": "4 a 7 dias",
"exams": 20
},
{
"label": "8 a 15 dias",
"exams": 14
},
{
"label": "16 a 30 dias",
"exams": 8
},
{
"label": "31 a 45 dias",
"exams": 3
}
],
"untracked": 5,
"expiredByExam": [
{
"id": 42,
"name": "Hemograma completo",
"requested": 30,
"expired": 6
}
]
}

pendingByDeadline agrupa os aguardando pelos dias que faltam para o prazo de 45 dias; timeToPerform agrupa os feitos pelos dias entre o pedido e a realização. medianDaysToPerform é null quando não há exame feito no período. Em pendingByDoctor, id 0 e nome Sem médico representam consultas sem médico.

400 Requisição inválida​

Mensagens possíveis:

  • erros de validação de from/to (data inválida) e de doctorId (doctorId aceita apenas números inteiros, doctorId deve ser positivo, Informe no máximo 50 médicos em doctorId)
  • A data final é anterior à inicial
{
"message": "A data final é anterior à inicial",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

503 Indisponível​

Mensagens possíveis: Acompanhamento de exames não configurado (sem ClickHouse no ambiente) e Acompanhamento de exames indisponível no momento (consulta falhou).

{
"message": "Acompanhamento de exames indisponível no momento",
"error": "Service Unavailable",
"statusCode": 503
}