Skip to main content
GET
/
consultas
/
{consulta_id}
curl -X GET https://api.vidaplus.com/consultas/1 \
  -H "Authorization: Bearer <token>"

{
  "id": 1,
  "data": "2025-04-28",
  "hora": "14:00:00",
  "paciente_id": 1,
  "profissional_id": 2,
  "status": "Agendada",
  "tipoConsulta": "Teleconsulta",
  "observacao": "Consulta de rotina"
}

​
Authentication

This endpoint requires authentication. Include a valid JWT token in the Authorization header. 
Authorization: Bearer <token>

​
Authorization

  • Superusers: Can view any appointment
  • Regular users: Can only view appointments where they are either the patient or the professional

​
Path Parameters

​
consulta_id
integer
required
The unique identifier of the appointment to retrieveExample: 1

​
Response

​
id
integer
The unique identifier for the appointment
​
data
date
The date of the appointment
​
hora
time
The time of the appointment
​
paciente_id
integer
The ID of the patient
​
profissional_id
integer
The ID of the healthcare professional
​
status
string
The status of the appointmentPossible values:
  • Agendada (Scheduled)
  • Realizada (Completed)
  • Cancelada (Cancelled)
  • Não Compareceu (No-show)
  • Reagendada (Rescheduled)
  • Pendente (Pending)
​
tipoConsulta
string
The type of appointmentPossible values:
  • Teleconsulta (Telemedicine)
  • Presencial (In-person)
​
observacao
string
Additional notes about the appointment
curl -X GET https://api.vidaplus.com/consultas/1 \
  -H "Authorization: Bearer <token>"

{
  "id": 1,
  "data": "2025-04-28",
  "hora": "14:00:00",
  "paciente_id": 1,
  "profissional_id": 2,
  "status": "Agendada",
  "tipoConsulta": "Teleconsulta",
  "observacao": "Consulta de rotina"
}

​
Error Codes

Status CodeDescription
200Appointment retrieved successfully
401Unauthorized - invalid or missing token
403Forbidden - user lacks permission to view this appointment
404Appointment not found

​
Notes

  • Users can only access appointments where they are involved as either the patient or the professional (unless they are superusers)
  • This endpoint is useful for retrieving full details of a specific appointment

Build docs developers (and LLMs) love

Get started for freeTalk to us