Skip to main content
POST
/
consultas
curl -X POST https://api.vidaplus.com/consultas/ \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "2025-04-28",
    "hora": "14:00",
    "paciente_id": 1,
    "profissional_id": 2,
    "prontuario_id": 1,
    "status": "Agendada",
    "tipoConsulta": "Teleconsulta",
    "link": "https://example.com/consulta",
    "observacao": "Consulta de rotina"
  }'

{
  "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

Only the professional associated with the appointment can create it. Superusers can create appointments for any professional.

​
Request Body

​
data
date
required
The date of the appointmentExample: 2025-04-28
​
hora
time
required
The time of the appointmentExample: 14:00
​
paciente_id
integer
required
The ID of the patient for this appointmentExample: 1
​
profissional_id
integer
required
The ID of the healthcare professional for this appointmentExample: 2
​
prontuario_id
integer
The ID of the medical record (prontuário) associated with this appointmentExample: 1
​
status
string
required
The status of the appointmentAllowed values:
  • Agendada (Scheduled)
  • Realizada (Completed)
  • Cancelada (Cancelled)
  • Não Compareceu (No-show)
  • Reagendada (Rescheduled)
  • Pendente (Pending)
Example: Agendada
​
tipoConsulta
string
required
The type of appointmentAllowed values:
  • Teleconsulta (Telemedicine)
  • Presencial (In-person)
Example: Teleconsulta
​
link
string
The link for virtual appointments (required for teleconsultas)Example: https://example.com/consulta
​
observacao
string
Additional notes or observations about the appointmentExample: Observação da consulta

​
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 appointment
​
tipoConsulta
string
The type of appointment
​
observacao
string
Additional notes about the appointment
curl -X POST https://api.vidaplus.com/consultas/ \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "2025-04-28",
    "hora": "14:00",
    "paciente_id": 1,
    "profissional_id": 2,
    "prontuario_id": 1,
    "status": "Agendada",
    "tipoConsulta": "Teleconsulta",
    "link": "https://example.com/consulta",
    "observacao": "Consulta de rotina"
  }'

{
  "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
201Appointment created successfully
400Invalid request body
401Unauthorized - invalid or missing token
403Forbidden - user lacks permission to create this appointment
404Professional, patient, or medical record not found
409Conflict - appointment already exists for this time slot

​
Business Rules

  • The patient, professional, and medical record must exist in the system
  • Cannot create duplicate appointments (same patient, professional, date, and time)
  • Only the assigned professional or a superuser can create the appointment
  • Non-superusers can only create appointments for themselves as the professional

Build docs developers (and LLMs) love

Get started for freeTalk to us