GET Buscar Doutores por Procedimento
Retorna a lista de médicos que realizam um procedimento específico, com filtros opcionais por data e horário.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
ID do procedimento
O procedureId pode ser obtido na rota de Listar Doutores, no campo doctorProcedures[].procedureId.
Endpoint
GET https://api-dev.imagemais.com.br/api/doctors/by-procedure/{procedureId}
Path Parameter
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
procedureId | number | ✅ | ID do procedimento — obtido em Listar Doutores, campo doctorProcedures[].procedureId |
Parâmetros de Query
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
date | string | ❌ | Data para verificar disponibilidade (ex: 2025-01-01) — obtida em Listar Doutores |
startTime | string | ❌ | Horário de início (ex: 08:00) — obtido em Listar Doutores, campo startTime |
appointmentId | number | ❌ | ID do agendamento (usado em reagendamentos) — obtido em Listar Agendamentos |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/doctors/by-procedure/3637' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
{
"data": [
{
"id": 4,
"name": "Dr. Victor Rocha ",
"isActive": true,
"accountId": 1,
"createdAt": "2026-08-26T13:07:20.524Z",
"updatedAt": "2026-09-17T16:29:03.024Z",
"deletedAt": null,
"isBusy": false,
"scheduleDays": [
{
"id": 109,
"doctorId": 4,
"accountId": 1,
"dayOfWeek": "QUA",
"startTime": "08:00",
"endTime": "18:00",
"intervalMinutes": 30,
"isActive": true,
"createdAt": "2026-09-17T16:29:03.024Z",
"updatedAt": "2026-09-17T16:29:03.024Z",
"deletedAt": null
},
{
"id": 110,
"doctorId": 4,
"accountId": 1,
"dayOfWeek": "QUI",
"startTime": "08:00",
"endTime": "18:00",
"intervalMinutes": 30,
"isActive": true,
"createdAt": "2026-09-17T16:29:03.024Z",
"updatedAt": "2026-09-17T16:29:03.024Z",
"deletedAt": null
}
],
"doctorProcedures": [
{
"doctorId": 4,
"procedureId": 21,
"procedure": {
"id": 21,
"name": "Ultrassom: Doppler Obstetrico 2/3 Trimestre",
"price": "100"
}
},
{
"doctorId": 4,
"procedureId": 22,
"procedure": {
"id": 22,
"name": "ULTRASSOM: ABDOME TOTAL",
"price": "100"
}
}
]
}
]
}
200 Sucesso — sem resultados
Retornado quando nenhum médico realiza o procedimento informado.
{
"data": []
}