RelatedPerson resource (FHIR R4)
RelatedPerson is the FHIR R4 resource for information about a person that is involved in the care for a patient, but who is not the target of healthcare, nor has a formal responsibility in the care process.
| Resource | RelatedPerson |
|---|---|
| FHIR version | R4 (4.0.1) |
| Canonical URL | http://hl7.org/fhir/StructureDefinition/RelatedPerson |
| Required elements | patient (1..1) |
| IG profiles in this catalog | 1 |
Example
{
"resourceType": "RelatedPerson",
"id": "relatedperson-fd6ae89c6e5884580a0ac280fd3af88f",
"active": true,
"patient": {
"reference": "Patient/patient-L46A6EIB9J"
},
"relationship": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
"code": "GUARD",
"display": "guardian"
}
]
}
],
"name": [
{
"use": "official",
"family": "Fuentes",
"given": [
"Jane"
]
}
],
"telecom": [
{
"system": "phone",
"value": "+1-555-546-4377",
"use": "home"
}
],
"gender": "female"
}Generated by the Pidgeon engine: pidgeon generate RelatedPerson --seed 20260722.
Validation context
- strict pidgeon validate grades a RelatedPerson 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 RelatedPersonWire it into your AI agent:
claude mcp add pidgeon -- npx -y @pidgeonhealth/mcpDownload Post free to browse this reference with generation attached.