Skip to main content

GET Buscar Agendamentos por Paciente

Busca todos os agendamentos de um paciente.

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


Endpoint​

GET https://api-dev.imagemais.com.br/api/appointments/patient/{id}

Parâmetros de Path​

NomeTipoObrigatórioDescrição
idnumber✅ID do paciente

Parâmetros de Query​

NomeTipoObrigatórioDescrição
limitnumber❌Quantidade de itens por página (inteiro positivo). Padrão: 20
cursornumber❌Cursor para paginação — use o valor de nextCursor da resposta anterior
dateInitialstring❌Data inicial do período no formato YYYY-MM-DD (só filtra se dateFinal também for enviado)
dateFinalstring❌Data final do período no formato YYYY-MM-DD (só filtra se dateInitial também for enviado)
statusstring❌Filtrar pelo status do agendamento (busca parcial). all desativa o filtro
doctorIdnumber❌Filtrar pelo ID do médico

Requisição​

curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/appointments/patient/14739' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
"data": [
{
"id": 4493,
"date": "2026-04-09T00:00:00.000Z",
"startTime": "08:30",
"endTime": "08:45",
"notes": "",
"status": {
"name": "Agendado"
},
"appointmentProcedures": {
"procedure": {
"name": "Ultrassom: Morfologico 1 Trimestre"
}
},
"doctor": {
"name": "Dra. Stella das Chagas"
}
}
],
"pagination": {
"nextCursor": null
}
}
CampoTipoDescrição
dataarrayLista de agendamentos do paciente
data[].idnumberID do agendamento
data[].datestringData do agendamento (ISO 8601)
data[].startTimestringHorário de início no formato HH:mm
data[].endTimestringHorário de término no formato HH:mm
data[].notesstringObservações do agendamento
data[].status.namestringNome do status
data[].doctor.namestringNome do médico
data[].appointmentProcedures.procedure.namestringNome do procedimento
pagination.nextCursornumber | nullCursor para buscar a próxima página. null indica que não há mais resultados

200 Paciente sem agendamentos​

Quando o ID informado não possui agendamentos, a resposta retorna data vazio sem gerar erro.

{
"data": [],
"pagination": {
"nextCursor": null
}
}