HL7 FHIR
☰
Home / Resources / FHIR Resources

HL7 FHIR R4 Resource Examples & Specifications

Technical reference library containing RESTful FHIR resource payloads, JSON schemas, field properties, and API integration endpoints.

Patient Resource

Demographic and administrative details regarding an individual receiving care.

GET /Patient/example-01
JSON Payload / FHIR R4 Standard 
{
  "resourceType": "Patient",
  "id": "example-01",
  "meta": { "versionId": "1", "lastUpdated": "2026-07-15T09:30:00Z" },
  "active": true,
  "identifier": [{
    "use": "official",
    "system": "http://hospital.org/mrn",
    "value": "MRN12345678"
  }],
  "name": [{
    "use": "official",
    "family": "Doe",
    "given": ["John", "Middle"]
  }],
  "telecom": [{ "system": "phone", "value": "+919642373173", "use": "mobile" }],
  "gender": "male",
  "birthDate": "1985-04-12",
  "address": [{
    "line": ["123 Main Street"],
    "city": "Hyderabad",
    "state": "Telangana",
    "postalCode": "500081",
    "country": "IND"
  }]
}

Field Property Breakdown

Property Key Type Description
identifier Identifier[] Business identifiers (e.g., Medical Record Number, National ID).
name HumanName[] Official, nickname, or maiden name elements (family, given).
telecom ContactPoint[] Contact details including phone numbers and email addresses.

Observation Resource

Measurements, laboratory test results, and simple assertions about a patient.

GET /Observation/glucose-01
JSON Payload / Laboratory Result 
{
  "resourceType": "Observation",
  "id": "glucose-01",
  "status": "final",
  "category": [{
    "coding": [{
      "system": "http://terminology.hl7.org/CodeSystem/observation-category",
      "code": "laboratory",
      "display": "Laboratory"
    }]
  }],
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "2345-7",
      "display": "Glucose [Mass/volume] in Blood"
    }]
  },
  "subject": { "reference": "Patient/example-01" },
  "effectiveDateTime": "2026-07-15T09:45:00Z",
  "valueQuantity": {
    "value": 110,
    "unit": "mg/dL",
    "system": "http://unitsofmeasure.org",
    "code": "mg/dL"
  }
}

Field Property Breakdown

Property Key Type Description
code CodeableConcept Identifies what was observed using standard coding systems (e.g., LOINC).
valueQuantity Quantity Quantitative measurement result value, unit, and system.
subject Reference Links the observation directly to a target `Patient` or `Group`.

Bundle Resource (Transaction)

A container collection for multiple FHIR resources sent as a single RESTful payload.

POST / (Transaction)
JSON Payload / Multi-Resource Bundle 
{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:p1",
      "resource": {
        "resourceType": "Patient",
        "name": [{ "family": "Smith", "given": ["Alice"] }],
        "gender": "female"
      },
      "request": { "method": "POST", "url": "Patient" }
    },
    {
      "fullUrl": "urn:uuid:o1",
      "resource": {
        "resourceType": "Observation",
        "status": "final",
        "subject": { "reference": "urn:uuid:p1" },
        "valueQuantity": { "value": 98.6, "unit": "degF" }
      },
      "request": { "method": "POST", "url": "Observation" }
    }
  ]
}

Field Property Breakdown

Property Key Type Description
type code Specifies bundle function (`transaction`, `batch`, `searchset`, `collection`).
entry BackboneElement[] Array containing individual resource payloads and REST request metadata.