QuestionnaireResponse

Overview

QuestionnaireResponse resource captures structured answers to a Questionnaire collected from patients, providers or devices at point of care.

Use Cases

Patient Intake - Capture and store patient intake questionnaire responses in health record.
Symptom Reporting - Allow patients to submit responses to daily symptom assessment questionnaires.
Clinical Data Capture - Digitize paper forms into structured questionnaire responses for EHR storage.
Patient Monitoring - Collect questionnaire responses on vital signs, quality of life, treatment effects over time.
Population Health - Aggregate and analyze questionnaire response data across patient cohorts.
Clinical Decision Support - Incorporate questionnaire response data into point-of-care CDS tools.
Clinical Research - Manage collection of study questionnaire responses electronically.
Care Plan Tracking - Assess care plan outcomes via questionnaire responses on goal achievement.
Quality Reporting - Generate compliance reports from questionnaire response data.
Workflow Integration - Trigger appropriate workflows based on questionnaire response analysis.

EHR Data Model

EHR	Supported?	Mapped Source Object
Athena	✅	Social History, GYN History, Perinatal History, Medical History
Elation	✅	History
Epic	✅	N/A

Object Definition

{
  "resourceType": "QuestionnaireResponse",
  "id": "3141",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n      <pre>\n            Comorbidity? YES\n              Cardial Comorbidity? YES\n                Angina? YES\n                MI? NO\n              Vascular Comorbidity?\n                (no answers)\n              ...\n            Histopathology\n              Abdominal\n                pT category: 1a\n              ...\n          </pre>\n    </div>"
  },
  "contained": [
    {
      "resourceType": "Patient",
      "id": "patsub",
      "identifier": [
        {
          "system": "http://cancer.questionnaire.org/systems/id/patientnr",
          "value": "A34442332"
        },
        {
          "type": {
            "text": "Dutch BSN"
          },
          "system": "urn:oid:2.16.840.1.113883.2.4.6.3",
          "value": "188912345"
        }
      ],
      "gender": "male",
      "birthDate": "1972-11-30"
    },
    {
      "resourceType": "ServiceRequest",
      "id": "order",
      "status": "unknown",
      "intent": "order",
      "subject": {
        "reference": "#patsub"
      },
      "requester": {
        "reference": "Practitioner/example"
      }
    },
    {
      "resourceType": "Practitioner",
      "id": "questauth",
      "identifier": [
        {
          "type": {
            "text": "AUMC, Den Helder"
          },
          "system": "http://cancer.questionnaire.org/systems/id/org",
          "value": "AUMC"
        }
      ]
    }
  ],
  "identifier": {
    "system": "http://example.org/fhir/NamingSystem/questionnaire-ids",
    "value": "Q12349876"
  },
  "basedOn": [
    {
      "reference": "#order"
    }
  ],
  "partOf": [
    {
      "reference": "Procedure/f201"
    }
  ],
  "status": "completed",
  "subject": {
    "reference": "#patsub"
  },
  "encounter": {
    "reference": "Encounter/example"
  },
  "authored": "2013-02-19T14:15:00-05:00",
  "author": {
    "reference": "#questauth"
  },
  "item": [
    {
      "linkId": "1",
      "item": [
        {
          "linkId": "1.1",
          "answer": [
            {
              "valueCoding": {
                "system": "http://cancer.questionnaire.org/system/code/yesno",
                "code": "1",
                "display": "Yes"
              },
              "item": [
                {
                  "linkId": "1.1.1",
                  "item": [
                    {
                      "linkId": "1.1.1.1",
                      "answer": [
                        {
                          "valueCoding": {
                            "system": "http://cancer.questionnaire.org/system/code/yesno",
                            "code": "1"
                          }
                        }
                      ]
                    },
                    {
                      "linkId": "1.1.1.2",
                      "answer": [
                        {
                          "valueCoding": {
                            "system": "http://cancer.questionnaire.org/system/code/yesno",
                            "code": "1"
                          }
                        }
                      ]
                    },
                    {
                      "linkId": "1.1.1.3",
                      "answer": [
                        {
                          "valueCoding": {
                            "system": "http://cancer.questionnaire.org/system/code/yesno",
                            "code": "0"
                          }
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "tag": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
        "code": "HTEST",
        "display": "test health data"
      }
    ]
  }
}

Data Fields

Data Field	Type	Description
resourceType	QuestionnaireResponse	This is a QuestionnaireResponse resource
id	id	The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
meta	Meta	The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
implicitRules	uri	A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.
language	code	The base language in which the resource is written.
text	Narrative	A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.
contained	BackboneElement	These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.
extension	Extension	May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
modifierExtension	Extension	May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
identifier	Identifier	A business identifier assigned to a particular completed (or partially completed) questionnaire.
basedOn	Reference	The order, proposal or plan that is fulfilled in whole or in part by this QuestionnaireResponse. For example, a ServiceRequest seeking an intake assessment or a decision support recommendation to assess for post-partum depression.
partOf	Reference	A procedure or observation that this questionnaire was performed as part of the execution of. For example, the surgery a checklist was executed as part of.
questionnaire	canonical	The Questionnaire that defines and organizes the questions for which answers are being provided.
status	code	The position of the questionnaire response within its overall lifecycle.
subject	Reference	The subject of the questionnaire response. This could be a patient, organization, practitioner, device, etc. This is who/what the answers apply to, but is not necessarily the source of information.
encounter	Reference	The Encounter during which this questionnaire response was created or to which the creation of this record is tightly associated.
authored	dateTime	The date and/or time that this set of answers were last changed.
author	Reference	Person who received the answers to the questions in the QuestionnaireResponse and recorded them in the system.
source	Reference	The person who answered the questions about the subject.
item	BackboneElement	A group or question item from the original questionnaire for which answers are provided.
item.id	string	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
item.extension	Extension	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
item.modifierExtension	Extension	May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
item.linkId	string	The item from the Questionnaire that corresponds to this item in the QuestionnaireResponse resource.
item.definition	uri	A reference to an [[[ElementDefinition]]] that provides the details for the item.
item.text	string	Text that is displayed above the contents of the group or as the text of the question being answered.
item.answer	BackboneElement	The respondent's answer(s) to the question.
item.answer.id	string	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
item.answer.extension	Extension	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
item.answer.modifierExtension	Extension	May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
item.answer.valueBoolean	boolean	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueDecimal	number	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueInteger	number	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueDate	string	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueDateTime	string	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueTime	string	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueString	string	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueUri	string	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueAttachment	Attachment	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueCoding	Coding	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueQuantity	Quantity	The answer (or one of the answers) provided by the respondent to the question.
item.answer.valueReference	Reference	The answer (or one of the answers) provided by the respondent to the question.

Extensions

Name	URL

QuestionnaireResponse

Overview

Use Cases

EHR Data Model

Object Definition

Data Fields

Extensions

Operations & APIs

QuestionnaireResponse-GET

QuestionnaireResponse-POST

QuestionnaireResponse ID-GET

QuestionnaireResponse ID-PUT

QuestionnaireResponse ID-DELETE

QuestionnaireResponse Export-POST