DTR API Endpoint

post

https://sandbox-apigw.optum.com/abm/dtr/v1

Accepts a FHIR DTR request and returns a FHIR response.

Use the stage query parameter to select the workflow step. If stage is omitted, the default is questionnaire-package.

Recommended call sequence:

documentation-requirements - Check whether documentation is required for the submitted coverage and order(s).
questionnaire-package - Retrieve PackageBundle containing Questionnare and QuestionnaireResponse.
next-question - Submit an in-progress QuestionnaireResponse to get the next question(s). Repeat until status is completed.
generate-guidance - Submit one or more completed QuestionnaireResponse resources to produce final documentation/guidance.

Query Params

stage

string

enum

Defaults to questionnaire-package

Execution stage. Selects which of the four DTR operations is executed and determines the expected request/response payload shape (see the operation description and the request examples for each stage). This is Optional - when it is not provided, the backend defaults to questionnaire-package.

Allowed:

Body Params

FHIR DTR request payload

FHIR payload, sent as raw JSON text. Shape depends on the stage query parameter: a FHIR Parameters resource (containing coverage + order, coverage + context, or coverage + questionnaire canonical entries) for documentation-requirements and questionnaire-package, a FHIR QuestionnaireResponse resource for next-question, and a FHIR Parameters resource containing one or more questionnaireResponse entries for generate-guidance. Server-side, this is received and passed through as a raw JSON string without deserialization into a typed object.

Response

200Successful DTR response