Person
type: StructureDefinition
node role: treeRoot
id:
  v: Person
language:
  v: en
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: StructureDefinition Person Language: en Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> Person 0..* Base Person OMOP Table Instances of this logical model can be the target of a Reference #xD; person_id 1..1 integer Person Identifier #xD; gender_concept_id 1..1 code Gender #xD; year_of_birth 1..1 integer Year of Birth #xD; month_of_birth 0..1 integer Month of Birth #xD; day_of_birth 0..1 integer Day of Birth #xD; birth_datetime 0..1 dateTime Birth Datetime #xD; race_concept_id 1..1 code Race #xD; ethnicity_concept_id 1..1 code Ethnicity #xD; location_id 0..1 integer Location #xD; provider_id 0..1 integer Provider #xD; care_site_id 0..1 integer Care Site #xD; person_source_value 0..1 string Person Identifier Source Value #xD; gender_source_value 0..1 string Gender Source Value #xD; gender_source_concept_id 0..1 code Gender Source Concept #xD; race_source_value 0..1 string Race Source Value #xD; race_source_concept_id 0..1 code Race Source Concept #xD; ethnicity_source_value 0..1 string Ethnicity Source Value #xD; ethnicity_source_concept_id 0..1 code Ethnicity Source Concept #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: 1
    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/Person
  l: Person
version:
  v: 1.0.0
name:
  v: Person
title:
  v: Person OMOP Table
status:
  v: active
date:
  v: 2026-04-02T22:51:15+00: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 serves as the central identity management for all Persons in the database. It contains records that uniquely identify each person or patient, and some demographic information.
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/Person
  l: Person
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: Person
    path:
      v: Person
    short:
      v: Person OMOP Table
    definition:
      v: This table serves as the central identity management for all Persons in the database. It contains records that uniquely identify each person or patient, and some demographic information.
    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: Person.person-id
    path:
      v: Person.person_id
    short:
      v: Person Identifier
    definition:
      v: It is assumed that every person with a different unique identifier is in fact a different person and should be treated independently.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: Person.person_id
      min:
        v: 1
      max:
        v: 1
    type:
      code:
        v: integer
        l: integer
  element:
    id:
      v: Person.gender-concept-id
    path:
      v: Person.gender_concept_id
    short:
      v: Gender
    definition:
      v: This field is meant to capture the biological sex at birth of the Person. This field should not be used to study gender identity issues.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: Person.gender_concept_id
      min:
        v: 1
      max:
        v: 1
    type:
      code:
        v: code
        l: code
  element:
    id:
      v: Person.year-of-birth
    path:
      v: Person.year_of_birth
    short:
      v: Year of Birth
    definition:
      v: Compute age using year_of_birth.
    min:
      v: 1
    max:
      v: 1
    base:
      path:
        v: Person.year_of_birth

v: 1

v: 1

code:
  v: integer
  l: integer

id:
  v: Person.month-of-birth
path:
  v: Person.month_of_birth
short:
  v: Month of Birth
definition:
  v: Month of Birth
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.month_of_birth
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: Person.day-of-birth
path:
  v: Person.day_of_birth
short:
  v: Day of Birth
definition:
  v: Day of Birth
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.day_of_birth
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: Person.birth-datetime
path:
  v: Person.birth_datetime
short:
  v: Birth Datetime
definition:
  v: Birth Datetime
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.birth_datetime
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: dateTime
    l: dateTime

id:
  v: Person.race-concept-id
path:
  v: Person.race_concept_id
short:
  v: Race
definition:
  v: This field captures race or ethnic background of the person.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Person.race_concept_id
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: Person.ethnicity-concept-id
path:
  v: Person.ethnicity_concept_id
short:
  v: Ethnicity
definition:
  v: This field captures Ethnicity as defined by the Office of Management and Budget (OMB) of the US Government: it distinguishes only between “Hispanic” and “Not Hispanic”. Races and ethnic backgrounds are not stored here.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Person.ethnicity_concept_id
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: Person.location-id
path:
  v: Person.location_id
short:
  v: Location
definition:
  v: The location refers to the physical address of the person. This field should capture the last known location of the person.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.location_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: Person.provider-id
path:
  v: Person.provider_id
short:
  v: Provider
definition:
  v: The Provider refers to the last known primary care provider (General Practitioner).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.provider_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: Person.care-site-id
path:
  v: Person.care_site_id
short:
  v: Care Site
definition:
  v: The Care Site refers to where the Provider typically provides the primary care.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.care_site_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer

id:
  v: Person.person-source-value
path:
  v: Person.person_source_value
short:
  v: Person Identifier Source Value
definition:
  v: Use this field to link back to persons in the source data. This is typically used for error checking of ETL logic.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.person_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: Person.gender-source-value
path:
  v: Person.gender_source_value
short:
  v: Gender Source Value
definition:
  v: This field is used to store the biological sex of the person from the source data. It is not intended for use in standard analytics but for reference only.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.gender_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: Person.gender-source-concept-id
path:
  v: Person.gender_source_concept_id
short:
  v: Gender Source Concept
definition:
  v: If the source data codes biological sex in a non-standard vocabulary, store the concept_id here.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.gender_source_concept_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: Person.race-source-value
path:
  v: Person.race_source_value
short:
  v: Race Source Value
definition:
  v: This field is used to store the race of the person from the source data. It is not intended for use in standard analytics but for reference only.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.race_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: Person.race-source-concept-id
path:
  v: Person.race_source_concept_id
short:
  v: Race Source Concept
definition:
  v: If the source data codes race in an OMOP supported vocabulary store the concept_id here.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.race_source_concept_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: code
    l: code

id:
  v: Person.ethnicity-source-value
path:
  v: Person.ethnicity_source_value
short:
  v: Ethnicity Source Value
definition:
  v: This field is used to store the ethnicity of the person from the source data. It is not intended for use in standard analytics but for reference only.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.ethnicity_source_value
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: Person.ethnicity-source-concept-id
path:
  v: Person.ethnicity_source_concept_id
short:
  v: Ethnicity Source Concept
definition:
  v: If the source data codes ethnicity in an OMOP supported vocabulary, store the concept_id here.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Person.ethnicity_source_concept_id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: code
    l: code

element:
  id:
    v: Person
  path:
    v: Person
  short:
    v: Person OMOP Table
  definition:
    v: This table serves as the central identity management for all Persons in the database. It contains records that uniquely identify each person or patient, and some demographic information.
element:
  id:
    v: Person.person-id
  path:
    v: Person.person_id
  short:
    v: Person Identifier
  definition:
    v: It is assumed that every person with a different unique identifier is in fact a different person and should be treated independently.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Person.gender-concept-id
  path:
    v: Person.gender_concept_id
  short:
    v: Gender
  definition:
    v: This field is meant to capture the biological sex at birth of the Person. This field should not be used to study gender identity issues.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: Person.year-of-birth
  path:
    v: Person.year_of_birth
  short:
    v: Year of Birth
  definition:
    v: Compute age using year_of_birth.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Person.month-of-birth
  path:
    v: Person.month_of_birth
  short:
    v: Month of Birth
  definition:
    v: Month of Birth
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Person.day-of-birth
  path:
    v: Person.day_of_birth
  short:
    v: Day of Birth
  definition:
    v: Day of Birth
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Person.birth-datetime
  path:
    v: Person.birth_datetime
  short:
    v: Birth Datetime
  definition:
    v: Birth Datetime
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: dateTime
      l: dateTime
element:
  id:
    v: Person.race-concept-id
  path:
    v: Person.race_concept_id
  short:
    v: Race
  definition:
    v: This field captures race or ethnic background of the person.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: Person.ethnicity-concept-id
  path:
    v: Person.ethnicity_concept_id
  short:
    v: Ethnicity
  definition:
    v: This field captures Ethnicity as defined by the Office of Management and Budget (OMB) of the US Government: it distinguishes only between “Hispanic” and “Not Hispanic”. Races and ethnic backgrounds are not stored here.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: code
      l: code
element:
  id:
    v: Person.location-id
  path:
    v: Person.location_id
  short:
    v: Location
  definition:
    v: The location refers to the physical address of the person. This field should capture the last known location of the person.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Person.provider-id
  path:
    v: Person.provider_id
  short:
    v: Provider
  definition:
    v: The Provider refers to the last known primary care provider (General Practitioner).
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Person.care-site-id
  path:
    v: Person.care_site_id
  short:
    v: Care Site
  definition:
    v: The Care Site refers to where the Provider typically provides the primary care.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Person.person-source-value
  path:
    v: Person.person_source_value

v: Person Identifier Source Value

v: Use this field to link back to persons in the source data. This is typically used for error checking of ETL logic.

v: 0

v: 1

code:
  v: string
  l: string

id:
  v: Person.gender-source-value
path:
  v: Person.gender_source_value
short:
  v: Gender Source Value
definition:
  v: This field is used to store the biological sex of the person from the source data. It is not intended for use in standard analytics but for reference only.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: Person.gender-source-concept-id
path:
  v: Person.gender_source_concept_id
short:
  v: Gender Source Concept
definition:
  v: If the source data codes biological sex in a non-standard vocabulary, store the concept_id here.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: code
    l: code

id:
  v: Person.race-source-value
path:
  v: Person.race_source_value
short:
  v: Race Source Value
definition:
  v: This field is used to store the race of the person from the source data. It is not intended for use in standard analytics but for reference only.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: Person.race-source-concept-id
path:
  v: Person.race_source_concept_id
short:
  v: Race Source Concept
definition:
  v: If the source data codes race in an OMOP supported vocabulary store the concept_id here.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: code
    l: code

id:
  v: Person.ethnicity-source-value
path:
  v: Person.ethnicity_source_value
short:
  v: Ethnicity Source Value
definition:
  v: This field is used to store the ethnicity of the person from the source data. It is not intended for use in standard analytics but for reference only.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: string
    l: string

id:
  v: Person.ethnicity-source-concept-id
path:
  v: Person.ethnicity_source_concept_id
short:
  v: Ethnicity Source Concept
definition:
  v: If the source data codes ethnicity in an OMOP supported vocabulary, store the concept_id here.
min:
  v: 0
max:
  v: 1
type:
  code:
    v: code
    l: code