Appointment resource (FHIR R4)

Appointment is the FHIR R4 resource for a booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time.

Example

{
  "resourceType": "Appointment",
  "id": "appointment-7c8eb432cf53a93b8052128d12bc502b",
  "status": "booked",
  "appointmentType": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v2-0276",
        "code": "FOLLOWUP",
        "display": "A follow up visit from a previous appointment"
      }
    ]
  },
  "description": "Outpatient clinic visit",
  "start": "2026-07-07T15:00:00Z",
  "end": "2026-07-07T15:45:00Z",
  "minutesDuration": 45,
  "created": "2026-07-01T12:00:00Z",
  "participant": [
    {
      "actor": {
        "reference": "Patient/patient-L46A6EIB9J"
      },
      "required": "required",
      "status": "accepted"
    },
    {
      "actor": {
        "display": "Dr. Attending Physician"
      },
      "required": "required",
      "status": "accepted"
    }
  ]
}

Generated by the Pidgeon engine: pidgeon generate Appointment --seed 20260722.

Validation context

• strict pidgeon validate grades a Appointment instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)
• strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)