Skip to main content

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​

CampoTipoObrigatórioDescrição
procedureIdnumber✅ID do procedimento — obtido em Listar Doutores, campo doctorProcedures[].procedureId

Parâmetros de Query​

NomeTipoObrigatórioDescrição
datestring❌Data para verificar disponibilidade (ex: 2025-01-01) — obtida em Listar Doutores
startTimestring❌Horário de início (ex: 08:00) — obtido em Listar Doutores, campo startTime
appointmentIdnumber❌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": []
}