FHIR Condition Resource (R5)

Condition captures a clinical problem, diagnosis or health concern: what it is (code), how sure we are (verificationStatus), whether it is current (clinicalStatus) and when it began (onset[x]). Element table, search parameters, example JSON and FHIRPath for FHIR R5.

FHIR Condition Resource (R5) — part of the free FHIR Toolbox library.
Runs entirely in your browser: your FHIR data is never uploaded to a server.

Overview

Condition captures a clinical problem, diagnosis or health concern: what it is (code), how sure we are (verificationStatus), whether it is current (clinicalStatus) and when it began (onset[x]). Problem lists, encounter diagnoses and health concerns are all Conditions distinguished by category.

Elements

Element	Type	Cardinality	Description
Condition.identifier	Identifier	0..*	External Ids for this condition
Condition.clinicalStatus	CodeableConcept	1..1	active \| recurrence \| relapse \| inactive \| remission \| resolved \| unknown
Condition.verificationStatus	CodeableConcept	0..1	unconfirmed \| provisional \| differential \| confirmed \| refuted \| entered-in-error
Condition.category	CodeableConcept	0..*	problem-list-item \| encounter-diagnosis
Condition.severity	CodeableConcept	0..1	Subjective severity of condition
Condition.code	CodeableConcept	0..1	Identification of the condition, problem or diagnosis
Condition.bodySite	CodeableConcept	0..*	Anatomical location, if relevant
Condition.subject	Reference	1..1	Who has the condition?
Condition.encounter	Reference	0..1	The Encounter during which this Condition was created
Condition.onset[x]	dateTime \| Age \| Period \| Range \| string	0..1	Estimated or actual date, date-time, or age
Condition.abatement[x]	dateTime \| Age \| Period \| Range \| string	0..1	When in resolution/remission
Condition.recordedDate	dateTime	0..1	Date condition was first recorded
Condition.participant	BackboneElement	0..*	Who or what participated in the activities related to the condition and how they were involved
Condition.participant.id	String	0..1	Unique id for inter-element referencing
Condition.participant.extension	Extension	0..*	Additional content defined by implementations
Condition.participant.modifierExtension	Extension	0..*	Extensions that cannot be ignored even if unrecognized
Condition.participant.function	CodeableConcept	0..1	Type of involvement
Condition.participant.actor	Reference	1..1	Who or what participated in the activities related to the condition
Condition.stage	BackboneElement	0..*	Stage/grade, usually assessed formally
Condition.stage.id	String	0..1	Unique id for inter-element referencing
Condition.stage.extension	Extension	0..*	Additional content defined by implementations
Condition.stage.modifierExtension	Extension	0..*	Extensions that cannot be ignored even if unrecognized
Condition.stage.summary	CodeableConcept	0..1	Simple summary (disease specific)
Condition.stage.assessment	Reference	0..*	Formal record of assessment
Condition.stage.type	CodeableConcept	0..1	Kind of staging
Condition.evidence	CodeableReference	0..*	Supporting evidence for the verification status
Condition.note	Annotation	0..*	Additional information about the Condition

Example JSON (R5)

{
  "resourceType": "Condition",
  "id": "example",
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
        "code": "active"
      }
    ]
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
        "code": "confirmed"
      }
    ]
  },
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/condition-category",
          "code": "problem-list-item"
        }
      ]
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "44054006",
        "display": "Type 2 diabetes mellitus"
      }
    ]
  },
  "subject": {
    "reference": "Patient/example"
  },
  "onsetDateTime": "2019-06-01"
}

FHIRPath

Condition.clinicalStatus.coding.code — Whether the condition is active, resolved…
Condition.code.coding.where(system='http://snomed.info/sct').code — SNOMED CT code
Condition.onset.ofType(dateTime) — Onset date

Common validation errors

Using clinicalStatus as a plain string. It is a CodeableConcept, so it needs coding with system and code.
Omitting subject. It is required (1..1).
Mixing up clinicalStatus (active, resolved) with verificationStatus (confirmed, refuted). They answer different questions.
Setting clinicalStatus on an entered-in-error Condition. When verificationStatus is entered-in-error, clinicalStatus must be absent.

FHIR Toolbox is a free, privacy-first collection of HL7 FHIR utilities by Omindra Labs. Every tool performs zero-server processing — your health data never leaves your device.