Skip to content

QuestionnaireResponse resource (FHIR R4)

QuestionnaireResponse is the FHIR R4 resource for a structured set of questions and their answers.

ResourceQuestionnaireResponse
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/QuestionnaireResponse
Required elementsstatus (1..1)
IG profiles in this catalog2

Example

{
  "resourceType": "QuestionnaireResponse",
  "id": "questionnaireresponse-31c54e7a6e06b41370d96eb2c22ae4dc",
  "status": "completed",
  "subject": {
    "reference": "Patient/patient-L46A6EIB9J"
  },
  "authored": "2026-07-01T12:00:00Z",
  "source": {
    "reference": "Patient/patient-L46A6EIB9J"
  },
  "item": [
    {
      "linkId": "smoking-status",
      "text": "Do you currently smoke or use tobacco products?",
      "answer": [
        {
          "valueBoolean": true
        }
      ]
    },
    {
      "linkId": "last-visit",
      "text": "When was your last primary care visit?",
      "answer": [
        {
          "valueDate": "2026-01-29"
        }
      ]
    },
    {
      "linkId": "medication-allergies",
      "text": "List any medication allergies.",
      "answer": [
        {
          "valueString": "Sulfa drugs (hives)"
        }
      ]
    }
  ]
}

Generated by the Pidgeon engine: pidgeon generate QuestionnaireResponse --seed 20260722.

Validation context

  • strict pidgeon validate grades a QuestionnaireResponse instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)
  • strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)

This answer, in your terminal

pidgeon lookup QuestionnaireResponse

Wire it into your AI agent:

claude mcp add pidgeon -- npx -y @pidgeonhealth/mcp

Download Post free to browse this reference with generation attached.

FHIR® R4 © Health Level Seven International. FHIR R4 specification content is used under its CC0 license; this page is a derivative work and is not endorsed by HL7 International.

HL7® and FHIR® are registered trademarks of Health Level Seven International.

Published by Pattern Engine LLC (Pidgeon Health).

Rendered from the same machine-readable definitions the Pidgeon engine validates against. Exported from the Pidgeon engine's FHIR R4 definitions (CC0); example generated with seed 20260722.