GET Buscar Agendamento por ID
Retorna os dados de um agendamento específico.
Autenticação necessária
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/{id}
Parâmetros de Path
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do agendamento |
Como obter o ID
O id do agendamento é retornado pela rota Listar Agendamentos.
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/appointments/5271' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
Retorna o agendamento dentro da propriedade data.
{
"data": {
"id": 73,
"date": "2026-09-18T00:00:00.000Z",
"startTime": "09:00",
"endTime": "09:30",
"notes": "",
"doctorId": 4,
"accountId": 1,
"createdByUserId": 1,
"createdAt": "2026-09-17T11:03:17.526Z",
"updatedAt": "2026-09-17T11:03:35.712Z",
"patient": {
"id": 53,
"name": "Maria Oliveira Santos",
"cpf": "12345678900",
"dateBirth": "1948-08-04T00:00:00.000Z",
"gender": {
"name": "M"
},
"contact": {
"phone": "(81) 99999-9999"
},
"address": {
"cep": "54510360"
}
},
"doctor": {
"name": "Dr. Victor Rocha ",
"doctorProcedures": [
{
"procedure": {
"id": 21,
"name": "Ultrassom: Doppler Obstetrico 2/3 Trimestre",
"price": "100",
"discounts": []
}
},
{
"procedure": {
"id": 22,
"name": "ULTRASSOM: ABDOME TOTAL",
"price": "100",
"discounts": []
}
}
],
"intervalMinutes": 30
},
"createdBy": {
"id": 1,
"name": "Ana Ferreira Souza"
},
"priorityAppointment": {
"id": 2,
"name": "Idoso"
},
"budget": {
"id": 106,
"budgetsProcedures": [
{
"id": 165,
"price": "132",
"procedure": {
"id": 14,
"name": "HISTONA - ANTICORPOS",
"price": "132",
"discounts": []
},
"discountBudgetsProcedures": null
}
],
"movements": [
{
"createdAt": "2026-09-17T11:03:29.562Z",
"value": "132",
"status": {
"name": "PAID"
},
"paymentMethod": {
"name": "PIX_PAGAMENTO_INSTANTANEO"
},
"movementsOptions": null
}
]
},
"appointmentProcedures": {
"id": 73,
"price": "132",
"discountsAppointmentProcedures": null,
"procedure": {
"id": 14,
"name": "HISTONA - ANTICORPOS",
"price": "132",
"laudoLocal": false,
"referral": null
}
},
"status": {
"name": "Finalizado",
"color": "#6B7280"
},
"movements": []
}
}
:::note Diferença em relação à listagem
Neste endpoint, data retorna um objeto único em vez de um array.
:::
404 Não Encontrado
Retornado quando o agendamento não existe na conta.
{
"message": "Agendamento não encontrado",
"error": "Not Found",
"statusCode": 404
}