Get Appointment by ID

curl --request GET \
  --url https://api.example.com/appointments/:id

{
  "appointment": {
    "id": 123,
    "patientID": 123,
    "professionalID": 123,
    "date": "<string>",
    "time": "<string>",
    "description": "<string>",
    "state": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

GET

appointments

:id

Get Appointment by ID

curl --request GET \
  --url https://api.example.com/appointments/:id

{
  "appointment": {
    "id": 123,
    "patientID": 123,
    "professionalID": 123,
    "date": "<string>",
    "time": "<string>",
    "description": "<string>",
    "state": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Overview

This endpoint retrieves a single appointment by its unique ID. Returns the complete appointment record including all fields.

Authentication

Requires a valid JWT token in the request headers.

Authorization: Bearer <jwt_token>

Path Parameters

number

required

The unique identifier of the appointment to retrieve.Example: 123

Response

Returns a single appointment object:

appointment

object

Show Appointment Details

number

Unique appointment identifier

patientID

number

ID of the patient this appointment belongs to

professionalID

number

ID of the professional assigned to this appointment

date

string

Appointment date in ISO 8601 format (YYYY-MM-DD)Example: "2026-03-15"

time

string

Appointment time in 24-hour format (HH:mm:ss)Example: "10:30:00"

description

string

Reason for the appointment or notes about what will be addressedExample: "Control mensual de diabetes"

state

string

Current state of the appointment. One of:

Pendiente - Scheduled and waiting
Atendido - Patient was seen and appointment completed
Cancelado - Appointment was cancelled
Ausente - Patient did not show up

createdAt

string

Timestamp when the appointment was created

updatedAt

string

Timestamp when the appointment was last updated

Examples