<status value="active"/> <experimental value="false"/> <date value="2025-08-24"/> <publisher value="HL7 International / Patient Empowerment"/> <contact> <name value="HL7 International / Patient Empowerment"/> <telecom> <system value="url"/> <value value="http://www.hl7.org/Special/committees/patientempowerment"/> </telecom> <telecom> <system value="email"/> <value value="patients@lists.HL7.org"/> </telecom> </contact> <description value="This section describes the expected capabilities of the PACIO Advance Directive Interoperability (ADI) Server actor which is responsible for providing responses to the queries submitted by the ADI Requestors. There are two primary vehicles in which Advance Directive Information can be conveyed: DocumentReference and Bundle. Through a DocumentReference, the ADI may be encoded inside directly as content data or referred to through a content reference (pointing to the ADI included in a resource like Binary) or reference a Bundle with the type=document for FHIR encoded data. The resources referred to by the Composition in the document bundle include Patient, Observation,Goal, ServiceRequest, Organization, RelatedPerson, Consent, List, and Provenance."/> <jurisdiction> <coding> <system value="urn:iso:std:iso:3166"/> <code value="US"/> <display value="United States of America"/> </coding> </jurisdiction> <kind value="requirements"/> <fhirVersion value="4.0.1"/> <format value="xml"/> <format value="json"/> <patchFormat value="application/json-patch+json"/> <implementationGuide value="http://hl7.org/fhir/us/pacio-adi/ImplementationGuide-hl7.fhir.us.fhir-pacio-adi"/> <rest> <mode value="server"/> <documentation value="The ADI Server **SHALL**: 1. Support all profiles defined in this Implementation Guide. 2. Implement the RESTful behavior according to the FHIR specification. 3. Return the following response classes: - (Status 400): invalid parameter - (Status 401/4xx): unauthorized request - (Status 403): insufficient scope - (Status 404): unknown resource - (Status 410): deleted resource. 4. Support json source formats for all ADI interactions. 5. Support the searchParameters on each profile individually and in combination. The ADI Server **SHOULD**: 1. Support xml source formats for all ADI interactions."/> <security> <description value="1. See the [Guidance](security_privacy_consent.html) section for requirements and recommendations. 1. A server **SHALL** reject any unauthorized requests by returning an HTTP 401 "Unauthorized", HTTP 403 "Forbidden", or HTTP 404 "Not Found" response code."/> </security> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <type value="Bundle"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="_id"/> <definition value="http://hl7.org/fhir/SearchParameter/Resource-id"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="composition"/> <definition value="http://hl7.org/fhir/SearchParameter/Bundle-composition"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="identifier"/> <definition value="http://hl7.org/fhir/SearchParameter/Bundle-identifier"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="timestamp"/> <definition value="http://hl7.org/fhir/SearchParameter/Bundle-timestamp"/> <type value="date"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="type"/> <definition value="http://hl7.org/fhir/SearchParameter/Bundle-type"/> <type value="token"/> </searchParam> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <type value="Composition"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-Composition-Header"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-PACPComposition"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-PMOComposition"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <type value="Consent"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-HealthcareAgentConsentPermit"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-HealthcareAgentConsentDeny"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <type value="DocumentReference"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-DocumentReference"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="_id"/> <definition value="http://hl7.org/fhir/SearchParameter/Resource-id"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="authenticator"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-authenticator"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="author"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-author"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="category"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-category"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="contenttype"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-contenttype"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="custodian"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-custodian"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="date"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-date"/> <type value="date"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="description"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-description"/> <type value="string"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="encounter"/> <definition value="http://hl7.org/fhir/SearchParameter/clinical-encounter"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="event"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-event"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="facility"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-facility"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="format"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-format"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="identifier"/> <definition value="http://hl7.org/fhir/SearchParameter/clinical-identifier"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="language"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-language"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="location"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-location"/> <type value="uri"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="patient"/> <definition value="http://hl7.org/fhir/SearchParameter/clinical-patient"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="period"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-period"/> <type value="date"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="related"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-related"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="relatesto"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-relatesto"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="relation"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-relation"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="relationship"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-relationship"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="security-label"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-security-label"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="setting"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-setting"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="status"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-status"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="subject"/> <definition value="http://hl7.org/fhir/SearchParameter/DocumentReference-subject"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="type"/> <definition value="http://hl7.org/fhir/SearchParameter/clinical-type"/> <type value="token"/> </searchParam> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <type value="Goal"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-PersonalGoal"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <type value="List"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-PersonalPrioritiesOrganizer"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <type value="Observation"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-DocumentationObservation"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-PersonalInterventionPreference"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-OrganDonationObservation"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-AutopsyObservation"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-PersonAuthoredCareExperiencePreference"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <type value="Organization"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <type value="Patient"/> <supportedProfile value="http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="_id"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter/us-core-patient-id"/> <type value="token"/> <documentation value="http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-id.html"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="active"/> <definition value="http://hl7.org/fhir/SearchParameter/Patient-active"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="address"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-address"/> <type value="string"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="address-city"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-address-city"/> <type value="string"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="address-country"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-address-country"/> <type value="string"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="address-postalcode"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-address-postalcode"/> <type value="string"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="address-state"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-address-state"/> <type value="string"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="address-use"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-address-use"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="birthdate"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter-us-core-patient-birthdate.html"/> <type value="date"/> <documentation value="http://hl7.org/fhir/us/core/SearchParameter-us-core-patient-birthdate.html.html"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="death-date"/> <definition value="http://hl7.org/fhir/SearchParameter/Patient-death-date"/> <type value="date"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="deceased"/> <definition value="http://hl7.org/fhir/SearchParameter/Patient-deceased"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="email"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-email"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="family"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter/us-core-patient-family"/> <type value="string"/> <documentation value="http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-family.html"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="general-practitioner"/> <definition value="http://hl7.org/fhir/SearchParameter/Patient-general-practitioner"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="given"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter/us-core-patient-given"/> <type value="string"/> <documentation value="http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-given.html"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="identifier"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter/us-core-patient-identifier"/> <type value="token"/> <documentation value="http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-identifier.html"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="language"/> <definition value="http://hl7.org/fhir/SearchParameter/Patient-language"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="link"/> <definition value="http://hl7.org/fhir/SearchParameter/Patient-link"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHALL"/> </extension> <name value="name"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter/us-core-patient-name"/> <type value="string"/> <documentation value="http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-name.html"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="organization"/> <definition value="http://hl7.org/fhir/SearchParameter/Patient-organization"/> <type value="reference"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="phone"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-phone"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="phonetic"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-phonetic"/> <type value="string"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <name value="telecom"/> <definition value="http://hl7.org/fhir/SearchParameter/individual-telecom"/> <type value="token"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="race"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter/us-core-race"/> <type value="token"/> <documentation value="http://www.hl7.org/fhir/us/core/SearchParameter-us-core-race.html"/> </searchParam> <searchParam> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <name value="ethnicity"/> <definition value="http://hl7.org/fhir/us/core/SearchParameter/us-core-ethnicity"/> <type value="token"/> <documentation value="http://www.hl7.org/fhir/us/core/SearchParameter-us-core-ethnicity.html"/> </searchParam> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <type value="Provenance"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-Provenance"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> <resource> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <type value="RelatedPerson"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-HealthcareAgentParticipant"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-Witness"/> <supportedProfile value="http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-Notary"/> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="create"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="search-type"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="read"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="vread"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="MAY"/> </extension> <code value="update"/> </interaction> <interaction> <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation"> <valueCode value="SHOULD"/> </extension> <code value="history-instance"/> </interaction> <referencePolicy value="resolves"/> </resource> </rest> </CapabilityStatement>

Generated Narrative: CapabilityStatement adi

ADI CapabilityStatement

Implementation Guide Version: 2.0.0-ballot
FHIR Version: 4.0.1
Supported Formats: xml, json
Supported Patch Formats: application/json-patch+json
Published on: 2025-08-24
Published by: HL7 International / Patient Empowerment

Note to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

SHALL Support the Following Implementation Guides

http://hl7.org/fhir/us/pacio-adi/ImplementationGuide-hl7.fhir.us.fhir-pacio-adi

FHIR RESTful Capabilities

Mode: `server`

The ADI Server SHALL:

Support all profiles defined in this Implementation Guide.
Implement the RESTful behavior according to the FHIR specification.
Return the following response classes:
- (Status 400): invalid parameter
- (Status 401/4xx): unauthorized request
- (Status 403): insufficient scope
- (Status 404): unknown resource
- (Status 410): deleted resource.
Support json source formats for all ADI interactions.
Support the searchParameters on each profile individually and in combination.

The ADI Server SHOULD:

Support xml source formats for all ADI interactions.

Security

See the Guidance section for requirements and recommendations.

A server SHALL reject any unauthorized requests by returning an HTTP 401 "Unauthorized", HTTP 403 "Forbidden", or HTTP 404 "Not Found" response code.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

The relevant profiles (if any)
The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
The required, recommended, and some optional search parameters (if any).
The linked resources enabled for _include
The other resources enabled for _revinclude
The operations on the resource (if any)

Resource Type	Profile	R	V-R	S	U	C	H-I	Searches
Bundle		Y	Y	Y	Y	Y	Y	_id, composition, identifier, timestamp, type
Composition	Supported Profiles ADI Composition Header ADI Person-Authored Composition ADI PMO Composition	y?	Y	y?	y?	y?	Y
Consent	Supported Profiles ADI Healthcare Agent Consent Permit ADI Healthcare Agent Consent Deny	y?	Y	y?	y?	y?	Y
DocumentReference	Supported Profiles ADI Document Reference	Y	Y	Y	Y	Y	Y	_id, authenticator, author, category, contenttype, custodian, date, description, encounter, event, facility, format, identifier, language, location, patient, period, related, relatesto, relation, relationship, security-label, setting, status, subject, type
Goal	Supported Profiles ADI Personal Goal	y?	Y	y?	y?	y?	Y
List	Supported Profiles ADI Personal Priorities Organizer	y?	Y	y?	y?	y?	Y
Observation	Supported Profiles ADI Documentation Observation ADI Person Authored Personal Intervention Preference ADI Organ Donation Observation ADI Autopsy Observation ADI Person-Authored Care Experience Preference	y?	y?	y?	y?	y?	Y
Organization		Y	Y	Y	Y	Y	Y
Patient	Supported Profiles US Core Patient Profile	Y	Y	Y	Y	Y	Y	_id, active, address, address-city, address-country, address-postalcode, address-state, address-use, birthdate, death-date, deceased, email, family, general-practitioner, given, identifier, language, link, name, organization, phone, phonetic, telecom, race, ethnicity
Provenance	Supported Profiles ADI Provenance	y?	Y	y?	y?	y?	Y
RelatedPerson	Supported Profiles ADI Healthcare Agent Participant ADI Witness ADI Notary	y?	Y	y?	y?	y?	Y

Resource Conformance: SHALL Bundle

Core FHIR Resource
Bundle

Reference Policy
resolves

Interaction summary

SHALL support create, read, update.
SHOULD support search-type, vread, history-instance.

Search Parameters

Conformance	Parameter	Type
SHOULD	_id	`token`
SHOULD	composition	`reference`
SHOULD	identifier	`token`
SHOULD	timestamp	`date`
SHOULD	type	`token`

Resource Conformance: MAY Composition

Core FHIR Resource
Composition

Reference Policy
resolves

Interaction summary

SHOULD support vread, history-instance.
MAY support create, search-type, read, update.

Supported Profiles

ADI Composition Header
ADI Person-Authored Composition
ADI PMO Composition

Resource Conformance: SHOULD Consent

Core FHIR Resource
Consent

Reference Policy
resolves

Interaction summary

SHOULD support vread, history-instance.
MAY support create, search-type, read, update.

Supported Profiles

ADI Healthcare Agent Consent Permit
ADI Healthcare Agent Consent Deny

Resource Conformance: SHALL DocumentReference

Core FHIR Resource
DocumentReference

Reference Policy
resolves

Interaction summary

SHALL support create, search-type, read, update.
SHOULD support vread, history-instance.

Supported Profiles

ADI Document Reference

Search Parameters

Conformance	Parameter	Type
SHALL	_id	`token`
SHALL	custodian	`reference`
SHALL	date	`date`
SHALL	identifier	`token`
SHALL	patient	`reference`
SHALL	period	`date`
SHALL	status	`token`
SHALL	type	`token`
SHOULD	category	`token`
SHOULD	contenttype	`token`
SHOULD	format	`token`
MAY	authenticator	`reference`
MAY	author	`reference`
MAY	description	`string`
MAY	encounter	`reference`
MAY	event	`token`
MAY	facility	`token`
MAY	language	`token`
MAY	location	`uri`
MAY	related	`reference`
MAY	relatesto	`reference`
MAY	relation	`token`
MAY	relationship	`reference`
MAY	security-label	`token`
MAY	setting	`token`
MAY	subject	`reference`

Resource Conformance: MAY Goal

Core FHIR Resource
Goal

Reference Policy
resolves

Interaction summary

SHOULD support vread, history-instance.
MAY support create, search-type, read, update.

Supported Profiles

ADI Personal Goal

Resource Conformance: MAY List

Core FHIR Resource
List

Reference Policy
resolves

Interaction summary

SHOULD support vread, history-instance.
MAY support create, search-type, read, update.

Supported Profiles

ADI Personal Priorities Organizer

Resource Conformance: MAY Observation

Core FHIR Resource
Observation

Reference Policy
resolves

Interaction summary

SHOULD support history-instance.
MAY support create, search-type, read, vread, update.

Supported Profiles

ADI Documentation Observation
ADI Person Authored Personal Intervention Preference
ADI Organ Donation Observation
ADI Autopsy Observation
ADI Person-Authored Care Experience Preference

Resource Conformance: SHALL Organization

Core FHIR Resource
Organization

Reference Policy
resolves

Interaction summary

SHALL support create, search-type, read, update.
SHOULD support vread, history-instance.

Resource Conformance: MAY Patient

Core FHIR Resource
Patient

Reference Policy
resolves

Interaction summary

SHALL support create, search-type, read, update.
SHOULD support vread, history-instance.

Supported Profiles

US Core Patient Profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	_id	`token`	http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-id.html
SHALL	birthdate	`date`	http://hl7.org/fhir/us/core/SearchParameter-us-core-patient-birthdate.html.html
SHALL	family	`string`	http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-family.html
SHALL	given	`string`	http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-given.html
SHALL	identifier	`token`	http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-identifier.html
SHALL	name	`string`	http://www.hl7.org/fhir/us/core/SearchParameter-us-core-patient-name.html
SHOULD	active	`token`
SHOULD	email	`token`
SHOULD	phone	`token`
SHOULD	telecom	`token`
MAY	address	`string`
MAY	address-city	`string`
MAY	address-country	`string`
MAY	address-postalcode	`string`
MAY	address-state	`string`
MAY	address-use	`token`
MAY	death-date	`date`
MAY	deceased	`token`
MAY	general-practitioner	`reference`
MAY	language	`token`
MAY	link	`reference`
MAY	organization	`reference`
MAY	phonetic	`string`
MAY	race	`token`	http://www.hl7.org/fhir/us/core/SearchParameter-us-core-race.html
MAY	ethnicity	`token`	http://www.hl7.org/fhir/us/core/SearchParameter-us-core-ethnicity.html

Resource Conformance: MAY Provenance

Core FHIR Resource
Provenance

Reference Policy
resolves

Interaction summary

SHOULD support vread, history-instance.
MAY support create, search-type, read, update.

Supported Profiles

ADI Provenance

Resource Conformance: MAY RelatedPerson

Core FHIR Resource
RelatedPerson

Reference Policy
resolves

Interaction summary

SHOULD support vread, history-instance.
MAY support create, search-type, read, update.

Supported Profiles

ADI Healthcare Agent Participant
ADI Witness
ADI Notary

ADI CapabilityStatement

SHALL Support the Following Implementation Guides

FHIR RESTful Capabilities

Mode: server

Capabilities by Resource/Profile

Summary

Resource Conformance: SHALL Bundle

Resource Conformance: MAY Composition

Resource Conformance: SHOULD Consent

Resource Conformance: SHALL DocumentReference

Resource Conformance: MAY Goal

Resource Conformance: MAY List

Resource Conformance: MAY Observation

Resource Conformance: SHALL Organization

Resource Conformance: MAY Patient

Resource Conformance: MAY Provenance

Resource Conformance: MAY RelatedPerson

Mode: `server`