---
title: "Entity: Data Point"
canonical: "https://wiki.patientsknowbest.com/space/api/3750395905/Entity%3A%20Data%20Point"
format: markdown
---
> Macro (toc)
These entities represent abstract concepts which are extended or used by other concrete data types.
# Mappings
| | | | | |
| --- | --- | --- | --- | --- |
| | **HL7 API** | **FHIR API** | **Web** | **Custom REST API** |
| | | **Facade (STU3)** | **Aggregated (R4)** | | |
| **Entity: Data Point** |
| Identifiers |
| **Data Point ID** `String`
A unique ID identifying this data point. This ID will not change even if the data point is modified. | | | | | |
| **Aggregated Data Point ID** `String`
Data Points that have been exposed in the [Aggregated FHIR endpoint](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3364388935) will have this additional ID populated. | | | This is the resource ID. | | |
| **External Data Point ID** `String`
The ID assigned to this data point by the source system. | [ORC-3.1 (ORU R01/radiology)](https://dev.patientsknowbest.com/home/hl7-api/messages/oru-r01/radiology)
[OBR-3.1 (ORU R01/radiology)](https://dev.patientsknowbest.com/home/hl7-api/messages/oru-r01/radiology)
[TXA-12.1 (MDM T02/care plan)](https://dev.patientsknowbest.com/home/hl7-api/messages/mdm-t02/care-plan)
[TXA-12.1 (MDM T02/document)](https://dev.patientsknowbest.com/home/hl7-api/messages/mdm-t02/document)
[SCH-1.1 (SIU)](https://dev.patientsknowbest.com/home/hl7-api/messages/siu-s12) | [DocumentReference.identifier](http://fhir.patientsknowbest.com/structuredefinition/facade-documentreference) | [Appointment.identifier](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365077229) | | |
| **Legacy Data Point ID** `String`
A unique ID for this version of this data point. This ID will change when the data point is updated. | | | [Appointment.identifier](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365077229) | | |
| Timestamps |
| **Entered Timestamp** `Timestamp`
Flexibly used, depending on the type of data. It is broadly intended to capture the timestamp when the data point was entered into the originating system. | [MSH-7](https://wiki.patientsknowbest.com/space/api/3365012972/MSH)
[TXA-4.1 (MDM T02/document)](https://dev.patientsknowbest.com/home/hl7-api/messages/mdm-t02/document)
[TXA-6.1 (MDM T02/document)](https://dev.patientsknowbest.com/home/hl7-api/messages/mdm-t02/document)
[TXA-7.1 (MDM T02/document)](https://dev.patientsknowbest.com/home/hl7-api/messages/mdm-t02/document)
[TXA-8.1 (MDM T02/document)](https://dev.patientsknowbest.com/home/hl7-api/messages/mdm-t02/document) | | [recorded-date](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3679715329) | | |
| **Persisted Timestamp** `Timestamp`
The timestamp when the data point was persisted in PKB. | | | [version-persisted](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3655761921) | | |
| Other |
| **Privacy Label** `Enum`
- GENERAL_HEALTH
- MENTAL_HEALTH
- SEXUAL_HEALTH
- SOCIAL_CARE | | meta.security
[Cosent.except.securityLabel](http://fhir.patientsknowbest.com/structuredefinition/facade-consent) | meta.security | Various, depending on data type | |
| **Specialty** `String`
The specialty associated with the data point. | PV1-10.1 | [specialty](http://fhir.patientsknowbest.com/structuredefinition/specialty) | [Appointment.specialty](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365077229) | Various, depending on data type | |
| **Entity: Source** |
| **Source Organisation** `Ref: [[Organisation.Public ID]]`
The organisation which created the data point. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3364848418/Connecting+to+PKB). | [source-organisation](http://fhir.patientsknowbest.com/structuredefinition/source-organisation)
[search param: source-organisation](http://fhir.patientsknowbest.com/searchparameter/source-organisation) | meta.security
(See also [code system: source-organization](https://pkbdev.atlassian.net/wiki/spaces/api/pages/3649830913/CS+Source+Organization)) | Various, depending on data type | |
| **Source Team** `Ref: [[Team.Public ID]]`
The team which created the data point. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3364848418/Connecting+to+PKB). | [source-team](http://fhir.patientsknowbest.com/structuredefinition/source-team) | meta.security
(See also [code system: source-team](https://pkbdev.atlassian.net/wiki/spaces/api/pages/3649863681/CS+Source+Team)) | Various, depending on data type | |
| **Source Person** `Ref: [[User.Public ID]]`
The PKB user who created the data point. | This value is never set for data sent via HL7. | [source-person](http://fhir.patientsknowbest.com/structuredefinition/source-person) | meta.security
(See also [code system: source-patient](https://pkbdev.atlassian.net/wiki/spaces/api/pages/3649896449/CS+Source+Patient), [code-system: source-practitioner](https://pkbdev.atlassian.net/wiki/spaces/api/pages/3649863706/CS+Source+Practitioner)) | Various, depending on data type | |
| **Source Text** `String`
Other source information that does not fit into one of the other source attributes. | [NTE-5 (ADT A28)](http://dev.patientsknowbest.com/home/hl7-api/messages/adt-a28)
[DG1-16 (ADT A28)](http://dev.patientsknowbest.com/home/hl7-api/messages/adt-a28)
[ZRX-13 (ADT A28)](http://dev.patientsknowbest.com/home/hl7-api/messages/adt-a28)
[OBR-16 (ORU R01)](http://dev.patientsknowbest.com/home/hl7-api/messages/oru-r01)
[TXA-5 (MDM T02/care plan)](https://dev.patientsknowbest.com/home/hl7-api/messages/mdm-t02/care-plan) | | [source-text](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365011691) | Various, depending on data type | |
| **Connecting Organisation** `Ref: [[Organisation.Public ID]]`
The organisation which connected to PKB in order to send the data point.
Currently, this cannot differ from the Source Organisation. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3365012161/Partner+connections). | | meta.security
(See also [code system: connecting-org](https://pkbdev.atlassian.net/wiki/spaces/api/pages/3712090113/CS+Connecting+Organisation)) | Various, depending on data type | |
| **HL7 Partner** `Ref: [[HL7 Partner.Public ID]]`
The HL7 Partner which delivered the data. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3365012161/Partner+connections). | | [partner-identifier](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3650682881) | Various, depending on data type | |
| **Responsible Organisation Identifier** `String`
An identifier for the organisation responsible for the data point. | [MSH-22.10](http://dev.patientsknowbest.com/home/hl7-api/segments/msh) | | [responsible-organization](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3649929217) | Various, depending on data type | |
| **Access Route** `Enum`
Represents the route used to access the PKB system when writing the data point.
For example, this can be used to differentiate between data that was entered manually in the web interface from data added by an API. | | | [access-route](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3591208961) | Various, depending on data type | |
| **Uploaded Data ID** `String`
The message which led to this data point. | | | [uploaded-data-id](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3655925761) | | |
| **Entity: HL7 Partner** |
| **Public ID** `String`
An ID for this HL7 Partner. | | | [partner-identifier](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3650682881) | | |
| **Name** `String`
The name of this HL7 Partner. | | | | Various, depending on data type | |
This entity is typically used to capture meta information about non-clinical entities, i.e. entities which do not have a Data Point or Source object.
| | | | | |
| --- | --- | --- | --- | --- |
| | **HL7 API** | **FHIR API** | **Web** | **Custom REST API** |
| | | **Facade (STU3)** | **Aggregated (R4)** | | |
| **Entity: Version Details** |
| **Source Organisation** `Ref: [[Organisation.Public ID]]`
The organisation which created the data. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3364848418/Connecting+to+PKB). | | [source-organization](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3587702785) | | |
| **Source Team** `Ref: [[Team.Public ID]]`
The team which created the data. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3364848418/Connecting+to+PKB). | | [source-team](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3364847752) | | |
| **Source Person** `Ref: [[User.Public ID]]`
The PKB user who created the data. | This value is never set for data sent via HL7. | | [source-patient](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3756130305)
[source-practitioner](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3756130332) | | |
| **Source Text** `String`
Other source information that does not fit into one of the other source attributes. | | | [source-text](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3365011691) | | |
| **Connecting Organisation** `Ref: [[Organisation.Public ID]]`
The organisation which connected to PKB in order to send the data point.
Currently, this cannot differ from the Source Organisation. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3365012161/Partner+connections). | | [connecting-org](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3756392449) | | |
| **HL7 Partner** `Ref: [[HL7 Partner.Public ID]]`
The HL7 Partner which delivered the data. | This is derived automatically from [the authenticated connection](https://wiki.patientsknowbest.com/space/api/3365012161/Partner+connections). | | [partner-identifier](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3650682881) | | |
| **Responsible Organisation Identifier** `String`
An identifier for the organisation responsible for the data. | [MSH-22.10](http://dev.patientsknowbest.com/home/hl7-api/segments/msh) | | [responsible-organization](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3649929217) | | |
| **Access Route** `Enum`
Represents the route used to access the PKB system when writing the data.
For example, this can be used to differentiate between data that was entered manually in the web interface from data added by an API. | | | [access-route](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3591208961) | | |
| **Entered Timestamp** `Timestamp`
Flexibly used, depending on the type of data. It is broadly intended to capture the timestamp when the data was entered into the originating system. | | | [entered-date](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3655729153) | | |
| **Created Timestamp** `Timestamp`
When the data was first created. | | | [created-date](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3755606017) | | |
| **Persisted Timestamp** `Timestamp`
When this version of the data was persisted. | | | [version-persisted](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/3655761921) | | |