FHIR Resources (Python)

Common errors

Warnings

Install

Install compatibility verified last tested: 2026-05-12

Imports

• Patient
  wrong

  from fhir_resources import Patient

  correct

  from fhir.resources.patient import Patient

  The package uses a namespace package 'fhir.resources'. Each resource type is in its own module with a lowercase name.

• Patient (R4)
  wrong

  from fhir.resources.patient import Patient  # this gives R5

  correct

  from fhir.resources.R4B.patient import Patient

  To use FHIR R4B resources, import from fhir.resources.R4B subpackage. Default top-level imports are R5.

• Patient (STU3)

  from fhir.resources.STU3.patient import Patient

  STU3 resources live under the fhir.resources.STU3 subpackage.

• Bundle

  from fhir.resources.bundle import Bundle

  Each FHIR resource is its own module. Import the class with the CamelCase name from the lowercase module.

Quickstart verified last tested: 2026-05-12

Create, validate, and serialize a FHIR Patient resource using Pydantic v2 methods.

from fhir.resources.patient import Patient

# Create from dict
patient_data = {
    "resourceType": "Patient",
    "id": "example",
    "active": True,
    "name": [
        {
            "use": "official",
            "family": "Doe",
            "given": ["John"]
        }
    ],
    "gender": "male",
    "birthDate": "1990-01-01"
}

patient = Patient.model_validate(patient_data)
print(patient.name[0].family)  # 'Doe'

# Serialize back to FHIR JSON
print(patient.model_dump_json(indent=2))

# Parse from JSON string
json_str = patient.model_dump_json()
patient2 = Patient.model_validate_json(json_str)
print(patient2.id)  # 'example'