Related Person

Related Person flow and relationships

RelatedPerson identifies a person related to the Patient (guardian, spouse, caregiver, etc.). Core relationship:

+----------------------+    patient.reference    +-----------------+
| RelatedPerson (R4)   | ----------------------> |  Patient (R4)   |
| id, relationship[]   |                         |  id             |
| patient              |                         +-----------------+
+----------------------+

Optional context (Observation performer):

+------------------+        performer[]        +----------------------+
| Observation (R4) | ------------------------> | RelatedPerson (R4)   |
+------------------+                            +----------------------+

Search flow returning RelatedPerson records by patient:

Client                                      FHIR API
  | GET /api/fhir/r4/RelatedPerson            |
  |     ?patient=Patient/{patient-id}          |
  |------------------------------------------->|
  | 200 Bundle (type=searchset)                |
  |<-------------------------------------------|

Primitive extension support

RelatedPerson supports primitive companion elements in underscore form for selected fields:

_active, _birthDate, _gender, _implicitRules, _language.

For JSON usage patterns, see FHIR primitive extensions in JSON.

Successful HTTP Responses

This table lists successful HTTP responses for this resource.

For cross-resource interaction summaries, see FHIR status codes.

See also

For permanent deletion guidance, see Data deletion and purge operations.