Documentation Templates and Rules (DTR) API
The Documentation Templates and Rules (DTR) API is a FHIR®-based interoperability API that streamlines the collection of patient documentation required by payer systems for prior authorization processing. It leverages FHIR® Questionnaire and QuestionnaireResponse resources to define and collect documentation, while enforcing secure access through the SMART on FHIR security framework and OAuth 2.0.
Capability Statement
Developers can access the Acentra Health FHIR server capabilities for Documentation Templates and Rules (DTR) API using the CapabilityStatement endpoint:
The capability statement describes the set of capabilities (behaviors) implemented by the FHIR Server to enable the Documentation Templates and Rules (DTR) API. For example, it describes the enabled profiles, interactions, and provides information about the authorization and token endpoints.
API Access Setup
FHIR 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.
The FHIR Base URL will be provided upon successful App Registration approval.
Getting Access Token
| Section | Key | Value |
|---|---|---|
| HTTP Method | POST | https://sb.fhir.mhbapp.com/sof/oauth2/token |
| HTTP Headers | content-type | application/json |
| accept | application/json | |
| authorization | Basic base 64({client_id}:{client_secret}) | |
| HTTP Body | code | {oauth code} |
| grant_type | authorization_code | |
| redirect_uri | {your_redirect_uri} |
Operations
Acentra Health Interoperability Solution’s Documentation Templates and Rules (DTR) API supports the following operations
| Operation | Endpoint |
|---|---|
| $questionnaire-package | https://sb.fhir.mhbapp.com/priorauth/$questionnaire-package |
Profiles
Acentra Health Interoperability Solution’s Documentation Templates and Rules (DTR) API supports the following profiles
| Profile |
|---|
| DTR Questionnaire Package Input Parameters |
| DTR Questionnaire Package Output Parameters |
| DTR Questionnaire Package Bundle |
| R4 Questionnaire |
| DTR Questionnaire Response |
Request Headers
All requests for Documentation Templates and Rules (DTR) API profiles require the following headers
| Header | Value |
|---|---|
| content-type | application/json |
| accept | application/json |
| authorization | Bearer |
Sandbox Test Data Catalog
Acentra Health Interoperability Solution’s Sandbox environment provides synthetic yet reliable test data to facilitate testing Documentation Templates and Rules (DTR) API. The dataset is representative of real-world scenarios and ensures consistency across related resources. The identifiers provided can be used to construct API requests for testing different workflow interactions.
Important Information for EHR Systems
| Topic | Reference |
|---|---|
| Privacy, Security and HIPAA | https://www.healthit.gov/topic/privacy-security-and-hipaa |
| ONC Model Privacy Notice | https://www.healthit.gov/topic/privacy-security-and-hipaa/model-privacy-notice-mpn |