Acentra Health · Interoperability Solution Sandbox Environment
EHR Bulk Exchange

Provider Access API

Standards-based access for EHR systems to retrieve member, claims and prior authorization data from payer systems using SMART Backend Services and FHIR Bulk Data.

Implementation GuideDa Vinci PDex
SecuritySMART Backend
Base Path/pd/api/v1
hub

Overview

The Provider Access API enables secure, standards-based access for EHR systems (consumers) to retrieve relevant member, claims, and prior authorization data from payer systems (producers).

It aligns with CMS-recommended implementation guides - the CARIN Common Payer Consumer Dataset (CPCDS), HL7® Da Vinci PDex, and FHIR® Bulk Data - and leverages HL7® FHIR® with SMART Backend Services Authorization.

Provider Access API
fact_check

Capability Statement

Developers can access the Acentra Health FHIR server capabilities for the Provider Access API using the CapabilityStatement endpoint:

METAhttps://sb.fhir.mhbapp.com/pd/api/v1/metadata
View JSON

The CapabilityStatement describes the supported profiles, interactions, search parameters, and authorization and token endpoints.

login

API Access Setup

settings_suggestFHIR SMART Configuration

Clients can retrieve SMART configuration details by invoking the SMART configuration endpoint at /.well-known/smart-configuration, appended to the FHIR Base URL.

vpn_key
The FHIR Base URL is provided upon successful App Registration approval.
key

Getting an Access Token

The Provider Access API uses SMART Backend Services authorization. Request an access token from the token endpoint using the client_credentials grant.

POSTToken Endpointhttps://sb.fhir.mhbapp.com/sof/oauth2/token
HTTP Headers
HeaderValue
content-typeapplication/x-www-form-urlencoded
acceptapplication/json
HTTP Body
ParameterValue
scope{scopes}
grant_typeclient_credentials
client_id{client_id}
client_secret{client_secret}
terminal

Operations

The Provider Access API supports the following operations.

POST $attribution-statushttps://sb.fhir.mhbapp.com/pd/api/v1/Group/[id]/$attribution-status
GET $davinci-data-exporthttps://sb.fhir.mhbapp.com/pd/api/v1/Group/[id]/$davinci-data-export
dataset

Resources

info
All resources are returned via the $davinci-data-export bulk export operation - individual REST endpoints are not available for these profiles.
Attribution
BULKGroupProvider GroupPDex
Member
BULKPatientPDex PatientPDex
BULKCoverageHRex CoverageHRex
BULKPractitionerCPCDS PractitionerCPCDS
BULKOrganizationCPCDS OrganizationCPCDS
BULKRelatedPersonCPCDS Related PersonCPCDS
Claims
BULKExplanationOfBenefitEOB Inpatient InstitutionalCARIN
BULKExplanationOfBenefitEOB Outpatient InstitutionalCARIN
BULKExplanationOfBenefitEOB Professional NonClinicianCARIN
BULKExplanationOfBenefitEOB OralCARIN
BULKExplanationOfBenefitEOB PharmacyCARIN
Authorization
BULKClaimPrior AuthorizationPDex
Audit
BULKProvenanceHRex ProvenanceHRex
http

Request Headers

All requests for Provider Access API profiles require the following headers:

HeaderValue
content-typeapplication/json
acceptapplication/json
authorizationBearer {access_token}
science

Sample Responses & Data

gpp_good

Important Information for EHR Systems

check