Skip to content

US Core Patient Profile (US Core 6.1.0)

US Core Patient Profile is a US Core 6.1.0 profile on the FHIR R4 Patient resource. It marks 17 elements as must-support; the rows below list each constrained element's cardinality and binding strength.

Profileus-core-patient
Implementation GuideUS Core 6.1.0
Base resourcePatient
Canonical URLhttp://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
Must-support elements17
Constrained elements with bindings6
Patient.identifier1..* (base 0..*), must support
Patient.identifier.system1..1 (base 0..1), must support
Patient.identifier.value1..1 (base 0..1), must support
Patient.name1..* (base 0..*), must support
Patient.name.family0..1, must support
Patient.name.given0..*, must support
Patient.telecom.system1..1, must support, binding: required
Patient.telecom.value1..1, must support
Patient.telecom.use0..1, must support, binding: required
Patient.gender1..1 (base 0..1), must support, binding: required
Patient.birthDate0..1, must support
Patient.address0..*, must support
Patient.address.line0..*, must support
Patient.address.city0..1, must support
Patient.address.state0..1, must support, binding: extensible
Patient.address.postalCode0..1, must support
Patient.communication.language1..1, must support, binding: extensible
Patient.link.other1..1
Patient.link.type1..1, binding: required

Example

pidgeon data install fhir-us-core-6.0
pidgeon conform --endpoint https://your-fhir-base/fhir --ig us-core-6.0 --ci

The conform run walks the live endpoint and grades sampled resources against the installed US Core profiles. A failed report exits non-zero; --ci also fails the run on must-support gaps (MUSTSUPPORT-*) and stub-profile fallbacks (CONFORM_STUB_PROFILE).

Validation context

  • strict Profile validation grades an instance against this profile's snapshot: cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)
  • strict Under pidgeon conform --ci, a sampled resource missing one of this profile's must-support elements fails the run with a MUSTSUPPORT-<element> rule id.
  • strict If the fhir-us-core-6.0 package is not installed, validation falls back to an embedded subset stub and the report is flagged CONFORM_STUB_PROFILE; under --ci that warning fails the run.(CONFORM_STUB_PROFILE)

This answer, in your terminal

pidgeon conform --endpoint https://your-fhir-base/fhir --ig us-core-6.0 --ci

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 installed fhir-us-core-6.0 package (6.1.0, CC0) through the Pidgeon engine's profile loader.