ConditionOccurrence
type: StructureDefinition
node role: treeRoot
id:
  v: ConditionOccurrence
language:
  v: en
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: StructureDefinition ConditionOccurrence Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> ConditionOccurrence 0..* Base Condition Occurrence OMOP Table Instances of this logical model can be the target of a Reference #xD; condition_occurrence_id 1..1 integer Condition Occurence Identifier #xD; person_id 1..1 integer Person #xD; condition_concept_id 1..1 code Condition #xD; condition_start_date 1..1 date Condition Start Date #xD; condition_start_datetime 0..1 dateTime Condition Start Datetime #xD; condition_end_date 0..1 date Condition End Date #xD; condition_end_datetime 0..1 dateTime Condition End Datetime #xD; condition_type_concept_id 1..1 code Condition Type #xD; condition_status_concept_id 0..1 code Condition Status #xD; stop_reason 0..1 string Stop Reason #xD; provider_id 0..1 integer Provider #xD; visit_occurrence_id 0..1 integer Visit Occurrence #xD; visit_detail_id 0..1 integer Visit Detail #xD; condition_source_value 0..1 string Condition Source Value #xD; <a href="StructureDefinition-ConditionOccurrence-definitions.html#ConditionOccurrence.condition-source-concept-id" title="This is the concept representing the condition source value and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Condition necessary for a given analytic use case. Consider using CONDITION_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.">condition_source_concept_id 0..1 code Condition Source Concept #xD; condition_status_source_value 0..1 string Condition Status Source Value #xD; <img src="[binary]" alt="doco" style="background-color: inherit"/> Documentation for this format
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics
    l: structuredefinition-type-characteristics
  value: Code
    v: can-be-target
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-wg
    l: structuredefinition-wg
  value: Code
    v: brr
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm
    l: structuredefinition-fmm
  value: Integer
    v: 2
    extension:
      url:
        v: http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom
        l: structuredefinition-conformance-derivedFrom
      value: Canonical
        v: http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop
        l: hl7.fhir.uv.omop
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status
    l: structuredefinition-standards-status
  value: Code
    v: informative
    extension:
      url:
        v: http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom
        l: structuredefinition-conformance-derivedFrom
      value: Canonical
        v: http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop
        l: hl7.fhir.uv.omop
url:
  v: http://hl7.org/fhir/uv/omop/StructureDefinition/ConditionOccurrence
  l: ConditionOccurrence
version:
  v: 1.0.0
name:
  v: ConditionOccurrence
title:
  v: Condition Occurrence OMOP Table
status:
  v: active
date:
  v: 2026-04-30T00:07:42+10:00
publisher:
  v: HL7 International / Biomedical Research and Regulation
contact:
  name:
    v: HL7 International / Biomedical Research and Regulation
  telecom:
    system:
      v: url
    value:
      v: http://www.hl7.org/Special/committees/rcrim
description:
  v: This table contains records of Events of a Person suggesting the presence of a disease or medical condition stated as a diagnosis, a sign, or a symptom, which is either observed by a Provider or reported by the patient.
jurisdiction:
  coding:
    system:
      v: http://unstats.un.org/unsd/methods/m49/m49.htm
      l: m49.htm
    code:
      v: 001
    display:
      v: World
fhir version:
  v: 5.0.0
mapping:
  identity:
    v: rim
  uri:
    v: http://hl7.org/v3
    l: v3
  name:
    v: RIM Mapping
kind:
  v: logical
abstract:
  v: false
type:
  v: http://hl7.org/fhir/uv/omop/StructureDefinition/ConditionOccurrence
  l: ConditionOccurrence
base definition:
  v: http://hl7.org/fhir/StructureDefinition/Base
  l: Base
derivation:
  v: specialization
snapshot:
  extension:
    url:
      v: http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version
      l: snapshot-base-version
    value: String
      v: 5.0.0
  element:
    id:
      v: ConditionOccurrence
    path:
      v: ConditionOccurrence
    short:
      v: Condition Occurrence OMOP Table
    definition:
      v: This table contains records of Events of a Person suggesting the presence of a disease or medical condition stated as a diagnosis, a sign, or a symptom, which is either observed by a Provider or reported by the patient.
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: Base
      min:
        v: 0
      max:
        v: *
    is modifier:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a
  element:
    id:
      v: ConditionOccurrence.condition-occurrence-id
    path:
      v: ConditionOccurrence.condition_occurrence_id
    short:
      v: Condition Occurence Identifier
    definition:
      v: The unique key given to a condition record for a person. Refer to the ETL for how duplicate conditions during the same visit were handled.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: ConditionOccurrence.condition_occurrence_id
      min:
        v: 1
      max:
        v: 1
    type:
      code:
        v: integer
        l: integer
  element:
    id:
      v: ConditionOccurrence.person-id
    path:
      v: ConditionOccurrence.person_id
    short:
      v: Person
    definition:
      v: The PERSON_ID of the PERSON for whom the condition is recorded.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: ConditionOccurrence.person_id
      min:
        v: 1
      max:
        v: 1
    type:
      code:
        v: integer
        l: integer
  element:
    id:
      v: ConditionOccurrence.condition-concept-id
    path:
      v: ConditionOccurrence.condition_concept_id
    short:
      v: Condition
    definition:
      v: The CONDITION_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies. This is the standard concept mapped from the source value which represents a condition
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: ConditionOccurrence.condition_concept_id

v: 1

v: 1

code:
  v: code
  l: code

id:
  v: ConditionOccurrence.condition-start-date
path:
  v: ConditionOccurrence.condition_start_date
short:
  v: Condition Start Date
definition:
  v: Use this date to determine the start date of the condition
min:
  v: 1
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_start_date
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: date
    l: date

id:
  v: ConditionOccurrence.condition-start-datetime
path:
  v: ConditionOccurrence.condition_start_datetime
short:
  v: Condition Start Datetime
definition:
  v: Condition Start Datetime
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_start_datetime
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: dateTime
    l: dateTime

id:
  v: ConditionOccurrence.condition-end-date
path:
  v: ConditionOccurrence.condition_end_date
short:
  v: Condition End Date
definition:
  v: Use this date to determine the end date of the condition
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_end_date
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: date
    l: date

id:
  v: ConditionOccurrence.condition-end-datetime
path:
  v: ConditionOccurrence.condition_end_datetime
short:
  v: Condition End Datetime
definition:
  v: Condition End Datetime
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_end_datetime
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: dateTime
    l: dateTime

id:
  v: ConditionOccurrence.condition-type-concept-id
path:
  v: ConditionOccurrence.condition_type_concept_id
short:
  v: Condition Type
definition:
  v: This field can be used to determine the provenance of the Condition record, as in whether the condition was from an EHR system, insurance claim, registry, or other sources.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_type_concept_id
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: ConditionOccurrence.condition-status-concept-id
path:
  v: ConditionOccurrence.condition_status_concept_id
short:
  v: Condition Status
definition:
  v: This concept represents the point during the visit the diagnosis was given (admitting diagnosis, final diagnosis), whether the diagnosis was determined due to laboratory findings, if the diagnosis was exclusionary, or if it was a preliminary diagnosis, among others.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_status_concept_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: ConditionOccurrence.stop-reason
path:
  v: ConditionOccurrence.stop_reason
short:
  v: Stop Reason
definition:
  v: The Stop Reason indicates why a Condition is no longer valid with respect to the purpose within the source data. Note that a Stop Reason does not necessarily imply that the condition is no longer occurring.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.stop_reason
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: ConditionOccurrence.provider-id
path:
  v: ConditionOccurrence.provider_id
short:
  v: Provider
definition:
  v: The provider associated with condition record, e.g. the provider who made the diagnosis or the provider who recorded the symptom.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.provider_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: ConditionOccurrence.visit-occurrence-id
path:
  v: ConditionOccurrence.visit_occurrence_id
short:
  v: Visit Occurrence
definition:
  v: The visit during which the condition occurred.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.visit_occurrence_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: ConditionOccurrence.visit-detail-id
path:
  v: ConditionOccurrence.visit_detail_id
short:
  v: Visit Detail
definition:
  v: The VISIT_DETAIL record during which the condition occurred. For example, if the person was in the ICU at the time of the diagnosis the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.visit_detail_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: ConditionOccurrence.condition-source-value
path:
  v: ConditionOccurrence.condition_source_value
short:
  v: Condition Source Value
definition:
  v: This field houses the verbatim value from the source data representing the condition that occurred. For example, this could be an ICD10 or Read code.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: ConditionOccurrence.condition-source-concept-id
path:
  v: ConditionOccurrence.condition_source_concept_id
short:
  v: Condition Source Concept
definition:
  v: This is the concept representing the condition source value and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Condition necessary for a given analytic use case. Consider using CONDITION_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_source_concept_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: ConditionOccurrence.condition-status-source-value
path:
  v: ConditionOccurrence.condition_status_source_value
short:
  v: Condition Status Source Value
definition:
  v: This field houses the verbatim value from the source data representing the condition status.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: ConditionOccurrence.condition_status_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

element:
  id:
    v: ConditionOccurrence
  path:
    v: ConditionOccurrence
  short:
    v: Condition Occurrence OMOP Table
  definition:
    v: This table contains records of Events of a Person suggesting the presence of a disease or medical condition stated as a diagnosis, a sign, or a symptom, which is either observed by a Provider or reported by the patient.
element:
  id:
    v: ConditionOccurrence.condition-occurrence-id
  path:
    v: ConditionOccurrence.condition_occurrence_id
  short:
    v: Condition Occurence Identifier
  definition:
    v: The unique key given to a condition record for a person. Refer to the ETL for how duplicate conditions during the same visit were handled.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: ConditionOccurrence.person-id
  path:
    v: ConditionOccurrence.person_id
  short:
    v: Person
  definition:
    v: The PERSON_ID of the PERSON for whom the condition is recorded.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: ConditionOccurrence.condition-concept-id
  path:
    v: ConditionOccurrence.condition_concept_id
  short:
    v: Condition
  definition:
    v: The CONDITION_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies. This is the standard concept mapped from the source value which represents a condition
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: ConditionOccurrence.condition-start-date
  path:
    v: ConditionOccurrence.condition_start_date
  short:
    v: Condition Start Date
  definition:
    v: Use this date to determine the start date of the condition
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: date
      l: date
element:
  id:
    v: ConditionOccurrence.condition-start-datetime
  path:
    v: ConditionOccurrence.condition_start_datetime
  short:
    v: Condition Start Datetime
  definition:
    v: Condition Start Datetime
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: dateTime
      l: dateTime
element:
  id:
    v: ConditionOccurrence.condition-end-date
  path:
    v: ConditionOccurrence.condition_end_date
  short:
    v: Condition End Date
  definition:
    v: Use this date to determine the end date of the condition
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: date
      l: date
element:
  id:
    v: ConditionOccurrence.condition-end-datetime
  path:
    v: ConditionOccurrence.condition_end_datetime
  short:
    v: Condition End Datetime
  definition:
    v: Condition End Datetime
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: dateTime
      l: dateTime
element:
  id:
    v: ConditionOccurrence.condition-type-concept-id
  path:
    v: ConditionOccurrence.condition_type_concept_id
  short:
    v: Condition Type
  definition:
    v: This field can be used to determine the provenance of the Condition record, as in whether the condition was from an EHR system, insurance claim, registry, or other sources.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: ConditionOccurrence.condition-status-concept-id
  path:
    v: ConditionOccurrence.condition_status_concept_id
  short:
    v: Condition Status
  definition:
    v: This concept represents the point during the visit the diagnosis was given (admitting diagnosis, final diagnosis), whether the diagnosis was determined due to laboratory findings, if the diagnosis was exclusionary, or if it was a preliminary diagnosis, among others.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: ConditionOccurrence.stop-reason
  path:
    v: ConditionOccurrence.stop_reason
  short:
    v: Stop Reason
  definition:
    v: The Stop Reason indicates why a Condition is no longer valid with respect to the purpose within the source data. Note that a Stop Reason does not necessarily imply that the condition is no longer occurring.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: string
      l: string
element:
  id:
    v: ConditionOccurrence.provider-id
  path:
    v: ConditionOccurrence.provider_id
  short:
    v: Provider
  definition:
    v: The provider associated with condition record, e.g. the provider who made the diagnosis or the provider who recorded the symptom.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: ConditionOccurrence.visit-occurrence-id
  path:
    v: ConditionOccurrence.visit_occurrence_id

v: Visit Occurrence

v: The visit during which the condition occurred.

v: 0

v: 1

code:
  v: integer
  l: integer

id:
  v: ConditionOccurrence.visit-detail-id
path:
  v: ConditionOccurrence.visit_detail_id
short:
  v: Visit Detail
definition:
  v: The VISIT_DETAIL record during which the condition occurred. For example, if the person was in the ICU at the time of the diagnosis the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: ConditionOccurrence.condition-source-value
path:
  v: ConditionOccurrence.condition_source_value
short:
  v: Condition Source Value
definition:
  v: This field houses the verbatim value from the source data representing the condition that occurred. For example, this could be an ICD10 or Read code.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: ConditionOccurrence.condition-source-concept-id
path:
  v: ConditionOccurrence.condition_source_concept_id
short:
  v: Condition Source Concept
definition:
  v: This is the concept representing the condition source value and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Condition necessary for a given analytic use case. Consider using CONDITION_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: code
    l: code

id:
  v: ConditionOccurrence.condition-status-source-value
path:
  v: ConditionOccurrence.condition_status_source_value
short:
  v: Condition Status Source Value
definition:
  v: This field houses the verbatim value from the source data representing the condition status.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string