GET Buscar Agendamentos por Paciente

Busca todos os agendamentos de um paciente.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

---

Endpoint

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

---

Parâmetros de Path

Nome	Tipo	Obrigatório	Descrição
id	number	✅	ID do paciente

---

Parâmetros de Query

Nome	Tipo	Obrigatório	Descrição
limit	number	❌	Quantidade de itens por página
cursor	number	❌	Cursor para paginação — use o valor de nextCursor da resposta anterior
dateInitial	string	❌	Data inicial do período no formato YYYY-MM-DD
dateFinal	string	❌	Data final do período no formato YYYY-MM-DD
status	string	❌	Filtrar pelo status do agendamento
doctorId	number	❌	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
  }
}

Campo	Tipo	Descrição
data	array	Lista de agendamentos do paciente
data[].id	number	ID do agendamento
data[].date	string	Data do agendamento (ISO 8601)
data[].startTime	string	Horário de início no formato HH:mm
data[].endTime	string	Horário de término no formato HH:mm
data[].notes	string	Observações do agendamento
data[].status.name	string	Nome do status
data[].doctor.name	string	Nome do médico
data[].appointmentProcedures.procedure.name	string	Nome do procedimento
pagination.nextCursor	number | null	Cursor 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
  }
}