Skip to content

Bundle resource (FHIR R4)

Bundle is the FHIR R4 resource for a container for a collection of resources.

ResourceBundle
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/Bundle
Required elementstype (1..1)
IG profiles in this catalog6

Example

{
  "resourceType": "Bundle",
  "id": "bundle-25e285bd761c1cb6a50ad9e9c09348c2",
  "type": "transaction",
  "timestamp": "2026-07-01T12:00:00Z",
  "entry": [
    {
      "fullUrl": "urn:uuid:patient-546cfad606fd5d5a484b1759514b8aff",
      "resource": {
        "resourceType": "Patient",
        "id": "patient-546cfad606fd5d5a484b1759514b8aff",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2026-07-01T12:00:00Z"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "MR",
                  "display": "Medical Record Number"
                }
              ]
            },
            "system": "http://hospital.example.org/mrn",
            "value": "L46A6EIB9J"
          }
        ],
        "active": true,
        "name": [
          {
            "use": "official",
            "family": "Fuentes",
            "given": [
              "Ola"
            ],
            "text": "Fuentes, Ola"
          }
        ],
        "gender": "female",
        "birthDate": "1983-08-28",
        "telecom": [
          {
            "system": "phone",
            "value": "(769)275-5693",
            "use": "home"
          }
        ],
        "address": [
          {
            "use": "home",
            "type": "physical",
            "line": [
              "6869 Canyon Pkwy"
            ],
            "city": "Miami",
            "state": "Oklahoma",
  ...

Generated by the Pidgeon engine: pidgeon generate Bundle --seed 20260722. Codes from licensed terminologies (LOINC, SNOMED CT, CPT, RxNorm) are omitted from published examples. Truncated for display; the command reproduces the full resource.

Validation context

  • strict pidgeon validate grades a Bundle 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)

This answer, in your terminal

pidgeon lookup Bundle

Wire it into your AI agent:

claude mcp add pidgeon -- npx -y @pidgeonhealth/mcp

Download Post free to browse this reference with generation attached.

FHIR® R4 © Health Level Seven International. FHIR R4 specification content is used under its CC0 license; this page is a derivative work and is not endorsed by HL7 International.

HL7® and FHIR® are registered trademarks of Health Level Seven International.

Published by Pattern Engine LLC (Pidgeon Health).

Rendered from the same machine-readable definitions the Pidgeon engine validates against. Exported from the Pidgeon engine's FHIR R4 definitions (CC0); example generated with seed 20260722.