Davinci Data Exchange
LMA

 
Please contact us if you would like to try out this early access feature.

Davinci-Data-Export Operation

 

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.

Request Parameters

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"}

Export Types

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.

Supported Parameters per Export Type

Export TypeSupported ParametersNot SupportedNotes
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.
Downloadpatient, _type, _since, _until, _typeFilter Updates the Member Attribution List.
Deltapatient, _until_type, _since, _typeFilterThe 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.
Snapshotpatient, _type, _since, _until, _typeFilter Does not update the Member Attribution List.
Payer-to-Payerpatient, _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.

Member Provider Operation

 

This operation returns a Bundle containing Organization resources representing a Member's attributed healthcare providers.

[fhir base]/$sdh.pdex.member-provider?patient=Patient%2F2325

Request Parameters

Name Optional? Multiple Allowed? Description Example
patient No No The patient id to obtain the attributed healthcare providers for. Patient/2325

Response Example

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.