The Davinci Data Exchange module enables the $davinci-data-export operation under the Da Vinci - Member Attribution (ATR) List IG. It is built on top of the FHIR Bulk Export Operation, and can be invoked on the Group-level (requiring the same permissions as a Group-level bulk export), using the endpoint
[fhir base]/Group/[id]/$davinci-data-export
Initiating a job is exactly the same as $export, with some additional parameters (see next section). Response is also the same, returning a polling URL once a job is initiated successfully, which would eventually resolve to a list of Binary file URLs that can be used to access the NDJSON data gathered as a part of the export.
For the Provider Access API, grant FHIR_OP_INITIATE_BULK_DATA_EXPORT_GROUPS_MATCHING with a search on the provider's business identifier rather than a permission for a single Group ID, because the provider's Groups are created over time. See Grant Permissions to the Provider System.
The following FHIR Bulk Export request parameters are supported: _type, _since, _typeFilter, _typePostFetchFilterUrl, _outputFormat and _exportId. Which of them each export type accepts is listed in Supported Parameters per Export Type. The _mdm and _includeHistory parameters are not supported and are ignored.
Send _since and _until as valueInstant, and send _type once, with a comma-separated list of resource types (for example Encounter,Coverage). If _type is repeated, only the first value is used.
The following parameters are also supported:
| Name | Optional? | Multiple Allowed? | Description | Example |
|---|---|---|---|---|
| exportType | No | No | The code that indicates the type of export to be performed. | hl7.fhir.us.davinci-pdex#provider-delta |
| _until | Yes | No | Only resources that were last updated before the given time will be included. If this parameter is absent, all resources created or updated before the job start time will be exported. This parameter is usually paired with the `_since` parameter. | 2019-10-25T11:14:00Z |
| patient | Yes | Yes | Only resources pertaining to a specific patient/member will be included. | {"reference":"Patient/1553"} |
The following export types are supported:
| Category | Description | Value |
|---|---|---|
| ATR |
Async export of Member Attribution List (Group, Patient, Coverage) Export the Attribution list (member/patient) to review |
hl7.fhir.us.davinci-atr |
| Download |
Async export and updates the FHIR group (member attribution list) The download of the data (intent for initial and can be subsequent) |
hl7.fhir.us.davinci-pdex#provider-download |
| Delta |
Async export and updates the FHIR group (member attribution list) Delta of initial to be more performant |
hl7.fhir.us.davinci-pdex#provider-delta |
| Snapshot |
Async export Provides snapshot for viewing purposes |
hl7.fhir.us.davinci-pdex#provider-snapshot |
| Payer-to-Payer |
Support multi-member Payer-to-Payer bulk data exchange Data exchanged is limited to data with a service date no earlier than 5 years prior to the date of the data request |
hl7.fhir.us.davinci-pdex#payertopayer |
Note that ATR, Download, Delta, and Snapshot can only be called on groups that have profile http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-provider-group, while Payer-to-payer requires groups to have the characteristic code match under the code system http://hl7.org/fhir/us/davinci-pdex/CodeSystem/PdexMultiMemberMatchResultCS.
| Export Type | Supported Parameters | Not Supported | Notes |
|---|---|---|---|
| ATR | _type (required), patient, _since, _until, _typeFilter | _type must include Group, Patient and Coverage, and may also include RelatedPerson, Practitioner, PractitionerRole, Organization and Location. The other parameters narrow the export to part of the Member Attribution List; the Group resource is always included. | |
| Download | patient, _type, _since, _until, _typeFilter | Updates the Member Attribution List. | |
| Delta | patient, _until | _type, _since, _typeFilter | The request is rejected with HTTP 400 if an unsupported parameter is present. _since is set by the server to the earliest last transmission date of the selected members; if any selected member has not been exported before, all of their data is exported. Updates the Member Attribution List. |
| Snapshot | patient, _type, _since, _until, _typeFilter | Does not update the Member Attribution List. | |
| Payer-to-Payer | patient, _type, _since, _until, _typeFilter | _since is limited to 5 years before the current date, and defaults to it when absent. |
When _type is absent, all resource types in the Patient compartment are exported (except for ATR, where _type is required).
The patient parameter selects members of the Group. Patients that are not members of the Group are listed in an OperationOutcome in the response. If none of the requested patients are members, the response is HTTP 202 with that OperationOutcome and no export job is started.
Download and Delta update the Member Attribution List: each selected Group.member is updated with the following extensions (all under http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/):
base-ext-last-transmission: the _until value if it is in the past, otherwise the time of the request.base-ext-last-types: the _type value. Removed when _type is absent.base-ext-last-typefilter: the _typeFilter values. Removed when _typeFilter is absent.This operation returns a Bundle containing Organization resources representing a Member's attributed healthcare providers.
[fhir base]/$sdh.pdex.member-provider?patient=Patient%2F2325
| Name | Optional? | Multiple Allowed? | Description | Example |
|---|---|---|---|---|
| patient | No | No | The patient id to obtain the attributed healthcare providers for. | Patient/2325 |
When attributed provider organizations are found, the response is a searchset Bundle of the Organization resources:
{
"resourceType": "Bundle",
"type": "searchset",
"total": 2,
"entry": [
{
"fullUrl": "Organization/2327/_history/1",
"resource": {
"resourceType": "Organization",
"id": "2327",
"meta": {
"versionId": "1",
"lastUpdated": "2026-03-31T22:13:58.612+08:00",
"source": "#wVvC8A2Eqxd4dAmZ"
},
"identifier": [
{
"system": "urn:oid:2.16.840.1.113883.4.4",
"value": "99-12345"
}
],
"name": "Test Organization"
}
},
{
"fullUrl": "Organization/2326/_history/1",
"resource": {
"resourceType": "Organization",
"id": "2326",
"meta": {
"versionId": "1",
"lastUpdated": "2026-03-31T22:13:58.603+08:00",
"source": "#L80U0mXjTYdnulFm"
},
"identifier": [
{
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1122334455"
}
],
"name": "Test Organization"
}
}
]
}
If the patient is not a member of any Provider Access Group, or no Organization matches the NPI or TIN identifiers of those Groups, the response is an OperationOutcome instead:
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "information",
"code": "informational",
"details": {
"text": "No attributed provider organizations found for the specified patient."
}
}
]
}
If the patient parameter is missing or is not a Patient/[id] reference, the request is rejected with HTTP 400 Bad Request.
You are about to leave the Smile Digital Health documentation and navigate to the Open Source HAPI-FHIR Documentation.