Linkage resource (FHIR R4)

Linkage is the FHIR R4 resource for identifies two or more records (resource instances) that refer to the same real-world "occurrence".

Resource	Linkage
FHIR version	R4 (4.0.1)
Canonical URL	http://hl7.org/fhir/StructureDefinition/Linkage
Required elements	item (1..*)

Example

{
  "resourceType": "Linkage",
  "id": "linkage-8c7cea7d601cefa8b8b59f8242bdf145",
  "item": [
    {
      "type": "source",
      "resource": {
        "reference": "Patient/patient-b750f49438bc16ba00db03a15f60ea80"
      }
    }
  ]
}

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

Validation context

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

This answer, in your terminal

pidgeon lookup Linkage

Wire it into your AI agent:

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

Download Post free to browse this reference with generation attached.