This page is part of the SDOH Clinical Care for Multiple Domains (v1.1.0: STU 2 Ballot 1) based on FHIR R4. The current version which supercedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions
Raw OpenAPI-Swagger Definition file | Download
(Requirements Definition Capability Statement)
Canonical URL: http://hl7.org/fhir/us/sdoh-clinicalcare/CapabilityStatement/SDOHCC-CoordinationPlatform Published: 2021-06 (draft)
This resource describes the required and desired behavior of systems acting as SDOH clinical care 'coordination platforms' (CPs).
FHIR Version: | 4.0.1 |
---|---|
Supported formats: | xml, json |
The clinical care coordinator needs to receive information from and update information in SDOH clinical care referral sources.
Security:
SMART-on-FHIRImplementations must meet the general privacy & security requirements documented in this implementation guide.
Resource | Search | Read | Read Version | Instance History | Resource History | Create | Update | Delete | Operations |
---|---|---|---|---|---|---|---|---|---|
CareTeam | MAY | MAY | |||||||
Condition | SHOULD | SHALL | |||||||
Consent | SHOULD | SHALL | |||||||
Device | SHOULD | SHOULD | |||||||
DocumentReference | SHOULD | SHALL | |||||||
Goal | SHOULD | SHALL | |||||||
HealthcareService | SHOULD | SHOULD | |||||||
Location | MAY | SHOULD | |||||||
Observation | SHOULD | SHALL | |||||||
Organization | SHOULD | SHALL | |||||||
Patient | SHOULD | SHALL | |||||||
Practitioner | SHOULD | SHALL | |||||||
PractitionerRole | SHOULD | SHALL | |||||||
Procedure | SHOULD | SHALL | SHALL | SHALL | |||||
Questionnaire | SHOULD | $populate: MAY | |||||||
QuestionnaireResponse | SHOULD | SHOULD | |||||||
RelatedPerson | MAY | MAY | |||||||
ServiceRequest | SHOULD | SHALL | |||||||
Subscription | SHOULD | MAY | $status: SHOULD
$topic-list: MAY |
||||||
Task | SHOULD |
SHALL
(conditional read: modified-since) |
SHALL | SHALL |
Name | Capability Statement | Description |
---|---|---|
batch | SHOULD |
Allows polling for changes to multiple resource types simultaneously |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known CareTeam records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Condition records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only SDOH-related conditions |
clinical-status | SHOULD | token |
Allows filtering to only active conditions |
code | SHOULD | token |
Allows filtering to only specific SDOH conditions or sets of conditions |
patient | SHALL | reference |
Allows filtering to only conditions associated with a specific patient. Some systems will require that searches be patient-specific |
verification-status | SHOULD | token |
Allows filtering to exclude refuted or entered-in-error conditions |
Supported Profile(s):
Reference policy: literal
Supported Includes: Consent:source-reference:DocumentReference
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known consent records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
source-reference | SHALL | reference |
Allows including the document that contains the PDF or similar representation of a paper consent |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Device records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHALL | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known DocumentReference records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Goal records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
achievement-status | SHOULD | token |
Allows filtering to only include unmet goals |
category | SHALL | token |
Allows filtering to only include SDOH-related goals |
lifecycle-status | SHOULD | token |
Allows filtering to only include active goals |
patient | SHALL | reference |
Allows filtering to only include goals for a particular patient. Some systems will require searches to be patient-specific |
target-date | SHOULD | date |
Allows filtering based on when a particular goal is desired to be achieved |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known HealthcareService records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
location | SHALL | reference |
Allows retrieval of the phyical site(s) associated with a HealthService |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Location records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Observation records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering for only SDOH-related observations |
code | SHOULD | token |
Allows filtering for specific types of observations |
code-value-concept | MAY | composite |
Allows filtering for observations that have a specific coded value answer for a specified observation type |
date | SHOULD | date |
Allows filtering for observations that held in a particular time period |
derived-from | SHOULD | reference |
Allows filtering for observations derived from a particular QuestionnaireResponse |
patient | SHALL | reference |
Allows filtering for observations specific to a particular patient. Some systems will require that all queries be patient-specific |
status | SHALL | token |
Allows filtering for observations that are completed or revised (i.e. not in-progress or entered-in-error) |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Organization records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Name | Conformance | Description |
---|---|---|
read | SHALL |
Allows the system to retrieve the Patient that is the subject of a ServiceRequest. |
search-type | SHOULD |
Allows the monitoring of previously-retrieved Patients. |
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Patient records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Practitioner records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Supported Includes: PractitionerRole:organization PractitionerRole:practitioner
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
organization | SHOULD | reference |
Allows doing an _include on Organization when retrieving the PractitionerRole |
practitioner | SHOULD | reference |
Allows doing an _include on Practitioner when retrieving the PractitionerRole |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
based-on | SHALL | reference |
Allows filtering for procedures resulting from a particular service request |
category | SHALL | token |
Allows filtering for procedures that are SDOH-related |
code | SHOULD | token |
Allows filtering for procedures based on the specific service delivered |
date | SHOULD | date |
Allows filtering for procedures based on when they were delivered |
patient | SHALL | reference |
Allows filtering for procedures based on who they were delivered to. Some systems may require that all searches be patient-specific. |
performer | SHALL | reference |
Allows filtering for procedures based on who delivered the procedure. |
status | SHALL | token |
Allows filtering for procedures that are complete or in progress |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
code | SHOULD | token |
Allows filtering for questionnaires associated with particular LOINC or similar codes |
context-type-value | SHOULD | composite |
Allows filtering for procedures that are SDOH-related |
identifier | SHOULD | token |
Allows retrieving Questionnaires with a known identifier |
publisher | SHOULD | string |
Allows retrieving Questionnaires based on who is responsible for them |
status | SHOULD | token |
Allows retrieving Questionnaires that are active (and not draft or required) |
subject-type | SHOULD | token |
Allows retrieving Questionnaires that are intended to be completed about patients - as opposed to practitioner, organizations, etc. |
title | SHOULD | string |
Allows retrieving Questionnaires based on the name of the form |
url | SHALL | uri |
Allows retrieving Questionnaires based on its canonical URL |
version | SHALL | token |
Allows retrieving a specific version of a Questionnaire |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known QuestionnaireResponse records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
author | SHALL | reference |
Allows filtering QuestionnaireResponses previously created/edited by a particular individual |
authored | SHOULD | date |
Allows filtering for QuestionnaireResponses by when they were created/last edited |
patient | SHALL | reference |
Allows retrieving QuestionnaireResponses associated with a particular patient. Some systems may only permit searches that are patient-specific |
questionnaire | SHALL | reference |
Allows retrieving QuestionnaireResponses that have been completed against a specified form |
status | SHALL | token |
Allows retrieving QuestionnaireResponses that are complete (or incomplete) |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known RelatedPerson records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Supported Includes: HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known ServiceRequests records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only retrieve ServiceRequests that are SDOH-related |
code | SHOULD | token |
Allows filtering to retrieve ServiceRequests for specific types of services |
intent | SHALL | token |
Allows filtering to retrieve only 'order' ServiceRequests and not plans, proposals, etc. |
occurrence | SHOULD | date |
Allows filtering to retrieve ServiceRequests based on the timeframe in which the service needs to be provided |
patient | SHALL | reference |
Allows filtering to retrieve only ServiceRequests associated with a particular patient. Note that some systems may mandate that searches are always patient-specific |
performer | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests that designate a specific performer |
requester | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests created by a specific practitioner |
status | SHALL | token |
Allows filtering to retrieve only active ServiceRequests |
supporting-info | SHOULD | reference |
Allows _include to retrieve supporting information for a ServiceRequest - particularly Consent |
Supported Profile(s):
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Supported Includes: Task:focus Task:output HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Task records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
code | SHALL | token |
Allows filtering for 'fulfill' tasks as opposed to others. Some systems may require code to be included as a filter criteria as different Task codes may correspond to different internal database tables. |
owner | SHOULD | reference |
Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned) |
patient | SHALL | reference |
Allows monitoring of tasks associated with a particular patient. (Some systems may require that all queries be done in the context of a single patient.) |
requester | SHALL | reference |
Allows retrieving all tasks that have been requested by a particular organization or individual. This will commonly be used to monitor the tasks initiated by a particular system |
status | SHALL | token |
Allows filtering to only active or completed tasks |
focus | SHALL | reference |
Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest |
output | SHOULD | reference |
Allows for the 'output' of a Task to be included when retrieving a Task |
Coordinating systems and service providers will frequently need to access information from the SDOH clinical care manager.
Security:
SMART-on-FHIRImplementations must meet the general privacy & security requirements documented in this implementation guide.
Resource | Search | Read | Read Version | Instance History | Resource History | Create | Update | Delete | Operations |
---|---|---|---|---|---|---|---|---|---|
CareTeam | MAY | MAY | |||||||
Condition | SHALL | SHALL | MAY | MAY | |||||
Consent | SHALL | SHALL | MAY | MAY | |||||
Device | SHOULD | SHOULD | |||||||
DocumentReference | SHALL | SHALL | SHALL | SHOULD | |||||
Goal | SHALL | SHALL | MAY | MAY | |||||
Group | SHALL | SHALL | |||||||
HealthcareService | SHOULD | SHOULD | |||||||
Location | MAY | SHOULD | |||||||
Observation | SHALL | SHALL | MAY | MAY | |||||
Organization | Yes | SHOULD | |||||||
Patient | SHALL | SHALL | |||||||
Practitioner | SHALL | SHALL | |||||||
PractitionerRole | SHALL | SHALL | |||||||
Procedure | SHALL | SHALL | SHALL | SHALL | |||||
Questionnaire | MAY | $populate: MAY | |||||||
QuestionnaireResponse | SHOULD | SHOULD | SHOULD | SHOULD | |||||
RelatedPerson | MAY | MAY | |||||||
ServiceRequest | SHALL | SHALL | MAY | MAY | |||||
Subscription | SHOULD | MAY | $status: SHOULD
$topic-list: MAY |
||||||
Task | SHALL |
SHALL
(conditional read: modified-since) |
SHALL | SHALL |
Name | Capability Statement | Description |
---|---|---|
batch | SHOULD |
Allows other systems to poll for changes to multiple resource types simultaneously |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known CareTeam records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Condition records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only SDOH-related conditions |
clinical-status | SHOULD | token |
Allows filtering to only active conditions |
code | SHOULD | token |
Allows filtering to only specific SDOH conditions or sets of conditions |
patient | SHALL | reference |
Allows filtering to only conditions associated with a specific patient. Some systems will require that searches be patient-specific |
verification-status | SHOULD | token |
Allows filtering to exclude refuted or entered-in-error conditions |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Supported Includes: Consent:source-reference:DocumentReference
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known consent records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
source-reference | SHALL | reference |
Allows including the document that contains the PDF or similar representation of a paper consent |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Device records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known DocumentReference records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Goal records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
achievement-status | SHOULD | token |
Allows filtering to only include unmet goals |
category | SHALL | token |
Allows filtering to only include SDOH-related goals |
lifecycle-status | SHOULD | token |
Allows filtering to only include active goals |
patient | SHALL | reference |
Allows filtering to only include goals for a particular patient. Some systems will require searches to be patient-specific |
target-date | SHOULD | date |
Allows filtering based on when a particular goal is desired to be achieved |
Supported Profile(s):
Reference policy: literal
Supported Includes: Group:member
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Group records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
characteristic-value | SHOULD | composite |
Allows filtering based on the insurer or plan associated with the group |
code | SHALL | token |
Allows filtering based on the type of group |
managing-entity | SHOULD | reference |
Allows filtering based on who is maintaining the group |
member | SHALL | reference |
Allows performing an _include to retrieve the members of the group |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known HealthcareService records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
location | SHALL | reference |
Allows retrieval of the phyical site(s) associated with a HealthService |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Location records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Observation records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering for only SDOH-related observations |
code | SHOULD | token |
Allows filtering for specific types of observations |
code-value-concept | MAY | composite |
Allows filtering for observations that have a specific coded value answer for a specified observation type |
date | SHOULD | date |
Allows filtering for observations that held in a particular time period |
derived-from | SHOULD | reference |
Allows filtering for observations derived from a particular QuestionnaireResponse |
patient | SHALL | reference |
Allows filtering for observations specific to a particular patient. Some systems will require that all queries be patient-specific |
status | SHALL | token |
Allows filtering for observations that are completed or revised (i.e. not in-progress or entered-in-error) |
Supported Profile(s):
Reference policy: literal
Parameter | Type | Definition & Chaining |
---|---|---|
_id | token |
Allows retrieving known Organization records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Patient records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Practitioner records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Reference policy: literal
Supported Includes: PractitionerRole:organization PractitionerRole:practitioner
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
organization | SHOULD | reference |
Allows doing an _include on Organization when retrieving the PractitionerRole |
practitioner | SHOULD | reference |
Allows doing an _include on Practitioner when retrieving the PractitionerRole |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known PractitionerRole records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
based-on | SHALL | reference |
Allows filtering for procedures resulting from a particular service request |
category | SHALL | token |
Allows filtering for procedures that are SDOH-related |
code | SHOULD | token |
Allows filtering for procedures based on the specific service delivered |
date | SHOULD | date |
Allows filtering for procedures based on when they were delivered |
patient | SHALL | reference |
Allows filtering for procedures based on who they were delivered to. Some systems may require that all searches be patient-specific. |
performer | SHALL | reference |
Allows filtering for procedures based on who delivered the procedure. |
status | SHALL | token |
Allows filtering for procedures that are complete or in progress |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
code | SHOULD | token |
Allows filtering for questionnaires associated with particular LOINC or similar codes |
context-type-value | SHOULD | composite |
Allows filtering for procedures that are SDOH-related |
identifier | SHOULD | token |
Allows retrieving Questionnaires with a known identifier |
publisher | SHOULD | string |
Allows retrieving Questionnaires based on who is responsible for them |
status | SHOULD | token |
Allows retrieving Questionnaires that are active (and not draft or required) |
subject-type | SHOULD | token |
Allows retrieving Questionnaires that are intended to be completed about patients - as opposed to practitioner, organizations, etc. |
title | SHOULD | string |
Allows retrieving Questionnaires based on the name of the form |
url | SHALL | uri |
Allows retrieving Questionnaires based on its canonical URL |
version | SHALL | token |
Allows retrieving a specific version of a Questionnaire |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known QuestionnaireResponse records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
author | SHALL | reference |
Allows filtering QuestionnaireResponses previously created/edited by a particular individual |
authored | SHOULD | date |
Allows filtering for QuestionnaireResponses by when they were created/last edited |
patient | SHALL | reference |
Allows retrieving QuestionnaireResponses associated with a particular patient. Some systems may only permit searches that are patient-specific |
questionnaire | SHALL | reference |
Allows retrieving QuestionnaireResponses that have been completed against a specified form |
status | SHALL | token |
Allows retrieving QuestionnaireResponses that are complete (or incomplete) |
Supported Profile(s):
Reference policy: literal
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known RelatedPerson records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Supported Includes: HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known ServiceRequests records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
category | SHALL | token |
Allows filtering to only retrieve ServiceRequests that are SDOH-related |
code | SHOULD | token |
Allows filtering to retrieve ServiceRequests for specific types of services |
intent | SHALL | token |
Allows filtering to retrieve only 'order' ServiceRequests and not plans, proposals, etc. |
occurrence | SHOULD | date |
Allows filtering to retrieve ServiceRequests based on the timeframe in which the service needs to be provided |
patient | SHALL | reference |
Allows filtering to retrieve only ServiceRequests associated with a particular patient. Note that some systems may mandate that searches are always patient-specific |
performer | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests that designate a specific performer |
requester | SHOULD | reference |
Allows filtering to retrieve only ServiceRequests created by a specific practitioner |
status | SHALL | token |
Allows filtering to retrieve only active ServiceRequests |
supporting-info | SHOULD | reference |
Allows _include to retrieve supporting information for a ServiceRequest - particularly Consent |
Supported Profile(s):
Supported Profile(s):
Versioning support: versioned-update
Reference policy: literal
Supported Includes: Task:focus Task:output HealthCareService:location ServiceRequest:supporting-info ServiceRequest:pertains-to-goal ServiceRequest:patient ServiceRequest:requester ServiceRequest:performer PractitionerRole:practitioner PractitionerRole:organization
Parameter | Conformance | Type | Definition & Chaining |
---|---|---|---|
_id | SHALL | token |
Allows retrieving known Task records - and more specifically, retrieving more than one in a single call to poll for updates |
_lastUpdated | SHOULD | date |
Allows filtering for only records that have changed since last query |
code | SHALL | token |
Allows filtering for 'fulfill' tasks as opposed to others. Some systems may require code to be included as a filter criteria as different Task codes may correspond to different internal database tables. |
owner | SHOULD | reference |
Allows filtering only for tasks that are assigned to a particular owner (or alternatively, tasks that have not yet been assigned) |
patient | SHALL | reference |
Allows monitoring of tasks associated with a particular patient. (Some systems may require that all queries be done in the context of a single patient.) |
requester | SHALL | reference |
Allows retrieving all tasks that have been requested by a particular organization or individual. This will commonly be used to monitor the tasks initiated by a particular system |
status | SHALL | token |
Allows filtering to only active or completed tasks |
focus | SHALL | reference |
Allows retrieving the task(s) seeking fulfillment of a particular ServiceRequest |
output | SHOULD | reference |
Allows for the 'output' of a Task to be included when retrieving a Task |