Example QuestionnaireResponse resource (GAD7)

This page contains the JSON for a QuestionnaireResponse generated from the advanced questionnaires feature. This QuestionnaireResponse was generated from a patient completing the GAD7 Questionnaire. This is the format you will receive the QuestionnaireResponse in when you retrieve it from the QuestionnaireResponse endpoint. This page is intended as a guide for how to read a QuestionnaireResponse resource retrieved from the PKB FHIR QuestionnaireResponse endpoint, to define various fields within the QuestionnaireResponse, and to show where the resource references other PKB FHIR resources.

JSON

{ "resourceType": "QuestionnaireResponse", "id": "2ccf20d2-1f36-4ef0-b99e-9b1f9f859c28", "meta": { "extension": [ { "url": "ex:createdAt", "valueInstant": "2024-12-09T10:32:39.165941Z" } ], "versionId": "17168", "lastUpdated": "2024-12-09T10:33:10.344586Z" }, "basedOn": [ { "reference": "ServiceRequest/61a84963-df7d-48f8-a3a1-1096c4548865" } ], "questionnaire": "http://fhir.patientsknowbest.com/questionnaire/gad7|1.0", "status": "completed", "subject": { "reference": "Patient/6935a405-efdc-4e4f-b330-862bcf0ae36a" }, "authored": "2024-12-09T10:33:10.226Z", "author": { "reference": "Patient/6935a405-efdc-4e4f-b330-862bcf0ae36a" }, "source": { "reference": "Patient/6935a405-efdc-4e4f-b330-862bcf0ae36a" }, "item": [ { "linkId": "48DwCGiy", "text": "Is this questionnaire being completed by you? ", "answer": [ { "valueCoding": { "code": "yes", "display": "Yes" } } ] }, { "linkId": "69725-0", "text": "Feeling nervous, anxious, or on edge", "answer": [ { "valueCoding": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/ordinalValue", "valueDecimal": 1 } ], "system": "http://loinc.org", "code": "LA6569-3", "display": "Several days" } } ] }, { "linkId": "68509-9", "text": "Not being able to stop or control worrying", "answer": [ { "valueCoding": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/ordinalValue", "valueDecimal": 0 } ], "system": "http://loinc.org", "code": "LA6568-5", "display": "Not at all" } } ] }, { "linkId": "69733-4", "text": "Worrying too much about different things", "answer": [ { "valueCoding": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/ordinalValue", "valueDecimal": 3 } ], "system": "http://loinc.org", "code": "LA6571-9", "display": "Nearly every day" } } ] }, { "linkId": "69734-2", "text": "Trouble relaxing", "answer": [ { "valueCoding": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/ordinalValue", "valueDecimal": 2 } ], "system": "http://loinc.org", "code": "LA6570-1", "display": "More than half the days" } } ] }, { "linkId": "69735-9", "text": "Being so restless that it is hard to sit still", "answer": [ { "valueCoding": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/ordinalValue", "valueDecimal": 0 } ], "system": "http://loinc.org", "code": "LA6568-5", "display": "Not at all" } } ] }, { "linkId": "69689-8", "text": "Becoming easily annoyed or irritable", "answer": [ { "valueCoding": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/ordinalValue", "valueDecimal": 1 } ], "system": "http://loinc.org", "code": "LA6569-3", "display": "Several days" } } ] }, { "linkId": "69736-7", "text": "Feeling afraid, as if something awful might happen", "answer": [ { "valueCoding": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/ordinalValue", "valueDecimal": 2 } ], "system": "http://loinc.org", "code": "LA6570-1", "display": "More than half the days" } } ] }, { "linkId": "/70274-6", "text": "GAD-7 Anxiety Severity Score", "answer": [ { "valueDecimal": 9 } ] } ] }

QuestionnaireResponse field definitions

The above QuestionnaireResponse resource is in JSON format and adheres to the FHIR R4 standard. The FHIR QuestionnaireResponse resource spec can be found here. Key information it contains includes:

Field

Description

Reference to other resource

Supported search parameter?

Notes

Field

Description

Reference to other resource

Supported search parameter?

Notes

id

Logical ID for the QuestionnaireResponse

 

Y

 

basedOn

The ServiceRequest that was generated when the questionnaire request was sent

ServiceRequest

Y

Can be included in the response using the _include search parameter

questionnaire

The canonical URL representing the Questionnaire that this response was generated from

 

N

Also on the Questionnaire resource in the url field.

status

The status of the QuestionnaireResponse

 

 

Updates as the patient starts and completes the questionnaire.

Statuses listed here.

subject

The patient that the questionnaire request was sent to

Patient

Y

 

authored

The date and time that the answers were submitted.

 

Y

Updates if the answers are amended by a patient or professional.

author

The individual that entered the answers into the UI

Patient

Practitioner

N

This will usually be the same as subject, apart from where a professional has amended a patient’s answers, when it will reference this professional’s Practitioner resource.

source

The individual who answered the questions

Patient

Y

This is functionally the same as subject in advanced questionnaires

item.linkId

ID representing the question

 

 

Links the question on the Questionnaire and QuestionnaireResponse resources

item.text

Question text

 

 

 

item.answer

Answer to the question

 

 

 

item.answer.valueCoding.code

Clinical code representing an answer option, for multiple choice questions

 

 

 

item.answer.valuecoding.display

Display value for the item.answer.valueCoding.code

 

 

 

item.answer.valueCoding.system

System for item.answer.valueCoding.code

 

 

 

ordinalValue extension

An ordinal value assigned to answer options, for multiple choice questions

 

 

Used in calculations within questionnaires