Da Vinci - Documentation Templates and Rules
2.2.0 - STU 2.2

Da Vinci - Documentation Templates and Rules, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 2.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-dtr/ and changes regularly. See the Directory of published versions

## OperationDefinition: DTR Next Question Operation

Official URL: http://hl7.org/fhir/us/davinci-dtr/OperationDefinition/DTR-Questionnaire-next-question | Version: 2.2.0 | Highlight text changes?
Standards status: Trial-use Active as of 2026-03-27 | Maturity Level: 2 | Computable Name: DTRNextQuestion

The Next Question operation is used for adaptive questionnaires. For specific details, see the SDC Next Question operation.

Language: en

URL: [base]/Questionnaire/$next-question

Input parameters Profile:DTR Next Question Input Parameters

Output parameters Profile:DTR Next Question Output Parameters

### Parameters

Use | Name | Scope | Cardinality | Type | Binding | Documentation
IN | questionnaire-response |  | 1..1 | QuestionnaireResponse |  | The DTR QuestionnaireResponse Profile of the QuestionnaireResponse resource with a contained Questionnaire. When invoking the operation for the first time, neither the QuestionnaireResponse nor the contained Questionnaire will have any items, as no questions are yet known. In subsequent calls, the QuestionnaireResponse will include answers to all required questions asked so far and the contained QuestionnaireResponse will remain the same as provided back from the operation in the preceding response.
OUT | return |  | 1..1 | QuestionnaireResponse |  | The DTR QuestionnaireResponse Profile of the QuestionnaireResponse resource with a contained Questionnaire. The Server updates the QuestionnaireResponse's contained Questionnaire by appending with the next question or questions ittems and any score or instruction items and returns the QuestionnaireResponse (with all answers completed thus far plus any calculated scores) as this parameter. When the questionnaire is complete, the Server updates the status of the QuestionnaireResponse resource parameter to `complete`.

To return a calculated score for the questionnaire or group of items, the service may return a `readOnly` question with the score value in the corresponding QuestionnaireResponse.item. The extension `questionnaire-hidden` can be included on the Questionnaire.item to indicate to the client that it should not be displayed to the end user