Resources: DSTU2: Condition

Condition resource

The Condition resource is used to retrieve a specific patient's conditions (DAF Condition). Conditions include problems and diagnoses.

To retrieve a patient's conditions, use the following syntax:

GET {FHIR URL}/FHIR/Patient/{ID}/Condition

To retrieve a patient's conditions that are categorized as problems, use the following syntax:

GET {FHIR URL}/FHIR/Patient/{ID}/Condition?category=problem

To retrieve a patient's conditions reported on January 1, 2016, use the following syntax:

GET {FHIR URL}/FHIR/Patient/{ID}/Condition?date=eq2016-01-01

Input parameters

Name Required? Type Description
ID Yes URL The patient's logical ID. This is retrieved using the search function.
date No string A string representing a date to include in the search. See below for more information.

Output specification

Name Type Cardinality Description
resourceType Condition
id identifier 0..* External ID for the condition. The ID is defined by business processes and/or used to refer to it when a direct URL reference to the resource itself is not appropriate. For example, in CDA documents or in written or printed documentation. This may include IMO, ICD9/10, or Medcin codes.
meta Contains metadata about the resource. Returns the profile element which includes a link to the Data Access Framework (DAF) for the Condition resource.
language code Contains the base language in which the resource is written. For more information, see here.
text Contains a human-readable version of the structured data, specifically an HTML representation generated by the data layer based on the underlying resource data.
patient Reference (Patient) 1..1 Patient name. This indicates the patient who the condition record is associated with. This is used for querying and retrieving patient demographic information.
  • reference: Returns the patient ID in the format Patient/[ID].
  • display: Returns the patient name in the format [Lastname],[Firstname].
encounter Reference (Encounter) 0..1 Encounter during which the condition was first asserted.
  • reference: Returns the encounter ID in the format Encounter/[ID].
  • display: Returns the encounter action. For example, Chart Update.
asserter Reference (Practitioner, Patient) 0..1 Individual who asserts the condition. This is a provider reference.
dateRecorded (date) 0..1 Date when the condition was first recorded. This is not the date on which the condition was last updated.
code CodeableConcept 1..1 ID of the condition, problem, or diagnosis. The value set includes content from SNOMED. For more information on this value set, see here. Each individual code is wrapped in coding and contains:
  • system: Returns a link to the coding source.
  • code: Returns the code for the condition.
  • display: Returns the condition display name.
category CodeableConcept 0..1 Condition category. Valid entries include: Complaint, Symptom, Finding, and Diagnosis. For more information on this value set, see here. Each individual category is wrapped in coding and contains:
  • system: Returns a link to the coding source.
  • code: Returns the code for the category.
  • display: Returns the category display name.
clinicalStatus code 0..1 Condition clinical status. Valid entries include: Active, Relapse, Remission, and Resolved. For more information on this value set, see here.
verificationStatus code 1..1 Condition verification status. Valid entries include: Provisional, Differential, Confirmed, Refuted, Entered-in-error, and Unknown. For more information on this value set, see here.
severity CodeableConcept 0..1 Subjective severity of condition. Valid entries include the following SNOMED codes: 399166001 Fatal, 24484000 Severe, 6736007 Moderate, and 255604002 Mild. For more information on this value set, see here.
onsetDateTime dateTime 0..1 Estimated or actual date, date-time, or age when the condition statement was documented. The Date Recorded indicates the date when this particular condition record was created in the EHR, not the date of the most recent update. For Allscripts TouchWorks EHR, onset date is pulled from Problem.OnsetFuzzyWhen.
onsetQuantity Quantity 0..1 Estimated or actual date, date-time, or age.
onsetPeriod Period 0..1 Estimated or actual date, date-time, or age.
onsetRange Hl7.Fhir.Model.Range 0..1 Estimated or actual date, date-time, or age.
onsetString String 0..1 Estimated or actual date, date-time, or age.
abatementDateTime dateTime 0..1 If/when in resolution/remission.
abatementQuantity Quantity 0..1 If/when in resolution/remission.
abatementBoolean Boolean 0..1 If/when in resolution/remission.
abatementPeriod Period 0..1 If/when in resolution/remission.
abatementRange Hl7.Fhir.Model.Range 0..1 If/when in resolution/remission.
abatementString String 0..1 If/when in resolution/remission.
stage 0..1 Stage/grade, usually assessed formally.
-- stage.summary CodeableConcept 0..1 Simple summary (disease specific). For more information on this value set, see here.
-- stage.assessment Reference (ClinicalImpression, DiagnosticReport, Observation) 0..* Formal record of assessment.
evidence 0..* Supporting evidence.
-- evidence.code CodeableConcept 0..1 Manifestation/symptom. For more information on this value set, see here.
-- evidence.detail Reference (Resource) 0..* Supporting information found elsewhere.
bodySite CodeableConcept 0..* Anatomical location, if relevant. For more information on this value set, see here.
notes string 0..1 Additional information about the condition.