GET Listar Agendamentos
Retorna a lista de agendamentos com filtros opcionais.
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Endpoint
GET https://api-dev.imagemais.com.br/api/appointments
Parâmetros de Query
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
date | string | ✅ | Data dos agendamentos no formato YYYY-MM-DD |
patientName | string | ❌ | Filtrar pelo nome do paciente |
status | string | ❌ | Filtrar pelo status (busca parcial, sem diferenciar maiúsculas). Valores: Agendado, Confirmado, Na fila, Em atendimento, Cancelado, Finalizado, Faltou. all desativa o filtro |
doctorId | number | ❌ | Filtrar pelo ID do médico |
patientId | number | ❌ | Filtrar pelo ID do paciente |
A listagem considera apenas agendamentos de médicos ativos e não excluídos. Para ver o histórico completo de um paciente (inclusive com médico inativo), use Buscar Agendamentos por Paciente. O resultado é ordenado por updatedAt crescente.
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/appointments?date=2026-05-11' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
Retorna um array de agendamentos dentro da propriedade data.
{
"data": [
{
"id": 72,
"patientId": 55,
"date": "2026-09-18T00:00:00.000Z",
"startTime": "08:30",
"endTime": "09:00",
"notes": "",
"accountId": 1,
"isFit": false,
"createdAt": "2026-09-17T10:59:16.826Z",
"updatedAt": "2026-09-17T11:00:45.791Z",
"deletedAt": null,
"doctor": {
"id": 4,
"name": "Dr. Victor Rocha ",
"percentage": 40,
"userId": null
},
"patient": {
"dateBirth": "2000-01-02T00:00:00.000Z",
"id": 55,
"name": "Maria Oliveira Santos",
"contact": {
"phone": "(81) 99999-9999"
}
},
"priorityAppointment": null,
"status": {
"id": 5,
"name": "Finalizado",
"color": "#6B7280"
},
"appointmentProcedures": {
"price": "100",
"discountsAppointmentProcedures": null,
"procedure": {
"id": 21,
"name": "Ultrassom: Doppler Obstetrico 2/3 Trimestre",
"price": "100"
}
}
}
]
}
Estrutura do objeto de retorno
Agendamento
| Campo | Tipo | Descrição |
|---|---|---|
id | number | Identificador único do agendamento |
date | string | Data do agendamento (ISO 8601) |
startTime | string | Horário de início no formato HH:mm |
endTime | string | Horário de término no formato HH:mm |
notes | string | Observações do agendamento |
patientId | number | ID do paciente |
accountId | number | ID da conta associada |
isFit | boolean | Indica se o agendamento é um encaixe |
priorityAppointment | object | null | Prioridade do atendimento (id, name): Gestante, Idoso, PcD ou Criança |
createdAt | string | Data de criação do registro |
updatedAt | string | Data da última atualização |
deletedAt | string | null | Data de exclusão (soft delete) |
doctor
| Campo | Tipo | Descrição |
|---|---|---|
id | number | ID do médico |
name | string | Nome do médico |
percentage | number | null | Percentual do médico sobre os procedimentos |
userId | number | null | ID do usuário vinculado ao médico |
patient
| Campo | Tipo | Descrição |
|---|---|---|
id | number | ID do paciente |
name | string | Nome do paciente |
dateBirth | string | Data de nascimento (ISO 8601) |
contact.phone | string | Telefone de contato |
status
| Campo | Tipo | Descrição |
|---|---|---|
id | number | ID do status |
name | string | Nome do status |
color | string | Cor em hexadecimal para exibição |
appointmentProcedures
| Campo | Tipo | Descrição |
|---|---|---|
price | string | Preço final após descontos |
procedure.id | number | ID do procedimento |
procedure.name | string | Nome do procedimento |
procedure.price | string | Preço original do procedimento |
discountsAppointmentProcedures | object | null | Desconto aplicado ao procedimento (veja abaixo) |
200 Sucesso — com descontos aplicados
Quando o procedimento do agendamento tem desconto, discountsAppointmentProcedures vem como objeto (a relação é 1:1; sem desconto, vem null). Na listagem, só descontos ativos são retornados, com discountId e value.
{
"appointmentProcedures": {
"price": "100",
"discountsAppointmentProcedures": {
"value": "10",
"discountId": 3
},
"procedure": {
"id": 21,
"name": "Ultrassom: Doppler Obstetrico 2/3 Trimestre",
"price": "100"
}
}
}
discountsAppointmentProcedures
| Campo | Tipo | Descrição |
|---|---|---|
discountId | number | ID do desconto aplicado |
value | string | Valor do desconto aplicado |
400 Bad Request
Retornado quando date não é enviado.
{
"message": [
"date must be a string"
],
"error": "Bad Request",
"statusCode": 400
}
500 Erro interno
{
"statusCode": 500,
"message": "Internal server error"
}