Skip to content
Partner Developer Portal

Schema

The core schema represents the Clinical Code schema derived from EMIS source systems.

Column NameData TypeDescriptionExample
is_deletedbooleanIndicates if this record should be considered soft deletedFALSE
organisationvarcharSet to ‘EMIS’‘EMIS’
code_idbigintThe unique EMIS code identifier for the clinical code1814041000006118
parent_code_idbigintThe parent code id, which is populated if EMIS code id has a parent code id.452768018
termvarcharThe description of the EMIS clinical code‘Pulmonary valvectomy’
read_term_idvarcharThe unique identifier mapped to the legacy NHS Read Codes v2 system.9Nu0
readv2_codevarcharThe code that provide a standard vocabulary for clinicians to record patient findings and procedures, in health and social care IT systems across primary and secondary care. These codes have been retired since 2016.9Nu0.00
snomed_concept_idbigintThe unique identifier for concepts within the SNOMED CT clinical terminology.827241000000103
snomed_description_idbigintThe unique identifier for the preferred term that describes the concept within the SNOMED CT clinical terminology.2151331000000115
national_code_category_idbigintThe unique identifier mapping to the national code category1
national_code_categoryvarcharThe category of the NHS national codes used for standardised classification of codes across NHS health records.ETHNIC CATEGORY
national_codevarcharThe NHS national code, defined for specific data items in NHS datasets.These include variables such as admission source, discharge destination, ethnic group, etc. National codes are also used to record the specialised service within which a patient is treated.A
national_descriptionvarcharThe description of the NHS National codeBritish
emis_code_category_idbigintEMIS internal identifier for code categories85
emis_code_category_descriptionvarcharThe description of the EMIS code categoryEthnicity
transform_datetimetimestamp(6) with time zoneThe timestamp indicating when the record was last processed and updated in the data model.‘2023-09-01 09:00:00.000000 UTC’
_execution_datevarcharThe transform_datetime formatted as yyyyMMddHHmmss. This column is provided only for backward compatibility.20241015070047

The table below presents the flavour specific schema and maps columns between core, V1, and V2. Refer to Changes in iPCV V2 for more information.

Column NameData TypesData in V1Data in V2Core MappingComments
_record_versionvarchar✓✗
_ingest_timevarchar✓✗
is_deletedboolean✗✓
emis_code_idbigint✓✓code_id
emis_code_category_idbigint✗✓
emis_codecategory_descriptionvarchar✓✓emis_code_category_description
national_codevarchar✓✓
national_code_category_idbigint✗✓
national_code_categoryvarchar✓✓
national_descriptionvarchar✓✓
parent_emis_code_idbigint✓✓parent_code_id
emis_old_codevarchar✓✓read_term_id
readv2_codevarchar✓✓
snomed_concept_idbigint✓✓
snomed_description_idbigint✓✓
emis_termvarchar✓✓term
organisationvarchar✓✓
transform_datetimetimestamp(6) with time zone✗✓
_execution_datevarchar✓✓

Not used in this schema

The table below presents the flavour specific schema and maps columns between core, V1, and V2. Refer to Changes in iPCV V2 for more information.

Column NameData TypesData in V1Data in V2Core MappingComments
_record_versionvarchar✓✗
_ingest_timevarchar✓✗
is_deletedboolean✗✓
emis_code_idbigint✓✓code_id
emis_code_category_idbigint✗✓
emis_codecategory_descriptionvarchar✓✓emis_code_category_description
national_codevarchar✓✓
national_code_category_idbigint✗✓
national_code_categoryvarchar✓✓
national_descriptionvarchar✓✓
parent_emis_code_idbigint✓✓parent_code_id
emis_old_codevarchar✓✓read_term_id
readv2_codevarchar✓✓
snomed_concept_idbigint✓✓
snomed_description_idbigint✓✓
emis_termvarchar✓✓term
organisationvarchar✓✓
transform_datetimetimestamp(6) with time zone✗✓
_execution_datevarchar✓✓

The table below presents the flavour specific schema.

Column NameData Type
is_deletedboolean
organisationvarchar
code_idbigint
parent_code_idbigint
termvarchar
read_term_idvarchar
readv2_codevarchar
snomed_concept_idbigint
snomed_description_idbigint
national_code_category_idbigint
national_code_categoryvarchar
national_codevarchar
national_descriptionvarchar
emis_code_category_idbigint
emis_code_category_descriptionvarchar
transform_datetimetimestamp(6) with time zone

Not used in this schema

The table below presents the flavour specific schema and maps columns between core, V1, and V2. Refer to Changes in iPCV V2 for more information.

Column NameData TypesData in V1Data in V2Core MappingComments
_ingest_timevarchar✓✗
is_deletedboolean✗✓
emis_code_idbigint✓✓code_id
emis_termvarchar✓✓term
emis_old_codevarchar✓✓read_term_id
snomed_concept_idbigint✓✓
snomed_description_idbigint✓✓
national_code_category_idbigint✗✓
national_codevarchar✓✓
national_code_categoryvarchar✓✓
national_descriptionvarchar✓✓
emis_code_category_idbigint✗✓
emis_code_category_descriptionvarchar✓✓
parent_emis_code_idbigint✓✓parent_code_id
processing_idbigint✓✓Always NULL as it is deprecated in v2. Refer changes in v2 for more details.
transform_datetimetimestamp(6) with time zone✗✓
organisationvarchar✓✓
_execution_datevarchar✓✓

The table below presents the flavour specific schema and maps columns between core, V1, and V2. Refer to Changes in iPCV V2 for more information.

Column NameData TypesData in V1Data in V2Core MappingComments
_ingest_timevarchar✓✗
is_deletedboolean✗✓
emis_code_idbigint✓✓code_id
emis_termvarchar✓✓term
emis_old_codevarchar✓✓read_term_id
snomed_concept_idbigint✓✓
snomed_description_idbigint✓✓
national_codevarchar✓✓
national_code_category_idbigint✗✓
national_code_categoryvarchar✓✓
national_descriptionvarchar✓✓
emis_code_category_idbigint✗✓
emis_code_category_descriptionvarchar✓✓
parent_emis_code_idbigint✓✓parent_code_id
processing_idbigint✓✓Always NULL as it is deprecated in v2. Refer changes in v2 for more details.
organisationvarchar✓✓
transform_datetimetimestamp(6) with time zone✗✓
_execution_datevarchar✓✓

The table below presents the flavour specific schema and maps columns between core, V1, and V2. Refer to Changes in iPCV V2 for more information.

Column NameData TypesData in V1Data in V2Core MappingComments
_ingest_timevarchar✓✗
is_deletedboolean✗✓
code_idbigint✓✓
parent_code_idbigint✓✓
termvarchar✓✓
read_term_idvarchar✓✓
snomed_ct_concept_idbigint✓✓snomed_concept_id
snomed_ct_description_idbigint✓✓snomed_description_id
national_codevarchar✓✓
national_code_category_idbigint✗✓
national_code_categoryvarchar✓✓
national_descriptionvarchar✓✓
emis_code_category_idbigint✗✓
emis_code_category_descriptionvarchar✓✓
processing_idbigint✓✓Always NULL as it is deprecated in v2. Refer changes in v2 for more details.
organisationvarchar✓✓
transform_datetimetimestamp(6) with time zone✗✓
_execution_datevarchar✓✓

The table below presents the flavour specific schema and maps columns between core, V1, and V2. Refer to Changes in iPCV V2 for more information.

Column NameData TypesData in V1Data in V2Core MappingComments
_record_versionvarchar✓✗
_ingest_timevarchar✓✗
is_deletedboolean✗✓
emis_code_idbigint✓✓code_id
emis_code_category_idbigint✗✓
emis_codecategory_descriptionvarchar✓✓emis_code_category_description
national_codevarchar✓✓
national_code_category_idbigint✗✓
national_code_categoryvarchar✓✓
national_descriptionvarchar✓✓
parent_emis_code_idbigint✓✓parent_code_id
emis_old_codevarchar✓✓read_term_id
readv2_codevarchar✓✓
snomed_concept_idbigint✓✓
snomed_description_idbigint✓✓
emis_termvarchar✓✓term
organisationvarchar✓✓
transform_datetimetimestamp(6) with time zone✗✓
_execution_datevarchar✓✓

The table below presents the flavour specific schema and maps columns between core, V1, and V2. Refer to Changes in iPCV V2 for more information.

Column NameData TypesData in V1Data in V2Core MappingComments
_record_versionvarchar✓✗
_ingest_timevarchar✓✗
is_deletedboolean✗✓
emis_code_idbigint✗✓code_id
emis_code_category_idbigint✗✓
emis_codecategory_descriptionvarchar✓✓emis_code_category_description
national_codevarchar✓✓
national_code_category_idbigint✗✓
national_code_categoryvarchar✓✓
national_descriptionvarchar✓✓
parent_emis_code_idbigint✓✓parent_code_id
emis_old_codevarchar✓✓read_term_id
readv2_codevarchar✓✓
snomed_concept_idbigint✓✓
snomed_description_idbigint✓✓
emis_termvarchar✓✓term
organisationvarchar✓✓
transform_datetimetimestamp(6) with time zone✗✓
_execution_datevarchar✓✓
data_filterinteger✓✗