Organisation Data Service (ODS) Implementation Guide

WARNING

This guidance is under active development by NHS England and content may be added or updated on a regular basis.

This site is provided for information only and it is advised not to develop against these specifications until a formal announcement has been made.

For more information, see the ODS Roadmap

Example - Organization FDC49

Important: This page is under development by NHS England

Tree View

Organization

id : ODS-Organization-FDC49-Example

extension

url : https://fhir.nhs.uk/England/StructureDefinition/Extension-England-OrganisationRole

extension

url : instanceID

value : 231843

extension

url : roleCode

value

coding

system : https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSOrganisationRole

code : RO94

display : APPLIANCE CONTRACTOR

extension

url : https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod

extension

url : dateType

value

system : https://fhir.nhs.uk/England/CodeSystem/England-PeriodType

code : Legal

display : Legal

extension

url : period

value

start : 2015-05-11

extension

url : https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod

extension

url : dateType

value

system : https://fhir.nhs.uk/England/CodeSystem/England-PeriodType

code : Operational

display : Operational

extension

url : period

value

start : 2015-05-11

extension

url : active

value : True

extension

url : https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedDateTime

extension

url : type

value

system : https://fhir.nhs.uk/England/CodeSystem/England-ODSDateTime

code : LastChangeDate

display : Last Change Date

extension

url : dateTime

value : 2020-09-24

identifier

use : official

system : https://fhir.nhs.uk/Id/ods-organization-code

value : FDC49

assigner

display : NHS BUSINESS SERVICES AUTHORITY

active : True

type

coding

system : https://fhir.nhs.uk/England/CodeSystem/England-ODSRecordUseType

code : Full

display : Full

type

coding

system : https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSRecordClass

code : RC1

display : HSCOrg

name : ATOS MEDICAL

telecom

system : phone

value : 01157 841906

address

line : LONGFIELDS COURT

line : WHARNCLIFFE BUSINESS PARK

city : BARNSLEY

postalCode : S71 3GN

country : ENGLAND

Table View

Organization.id[0]	ODS-Organization-FDC49-Example
Organization.extension[0].extension[0].url[0]	instanceID
Organization.extension[0].extension[0].value[0]	231843
Organization.extension[0].extension[1].url[0]	roleCode
Organization.extension[0].extension[1].value[0].coding[0].system[0]	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSOrganisationRole
Organization.extension[0].extension[1].value[0].coding[0].code[0]	RO94
Organization.extension[0].extension[1].value[0].coding[0].display[0]	APPLIANCE CONTRACTOR
Organization.extension[0].extension[2].extension[0].url[0]	dateType
Organization.extension[0].extension[2].extension[0].value[0].system[0]	https://fhir.nhs.uk/England/CodeSystem/England-PeriodType
Organization.extension[0].extension[2].extension[0].value[0].code[0]	Legal
Organization.extension[0].extension[2].extension[0].value[0].display[0]	Legal
Organization.extension[0].extension[2].extension[1].url[0]	period
Organization.extension[0].extension[2].extension[1].value[0].start[0]	2015-05-11
Organization.extension[0].extension[2].url[0]	https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod
Organization.extension[0].extension[3].extension[0].url[0]	dateType
Organization.extension[0].extension[3].extension[0].value[0].system[0]	https://fhir.nhs.uk/England/CodeSystem/England-PeriodType
Organization.extension[0].extension[3].extension[0].value[0].code[0]	Operational
Organization.extension[0].extension[3].extension[0].value[0].display[0]	Operational
Organization.extension[0].extension[3].extension[1].url[0]	period
Organization.extension[0].extension[3].extension[1].value[0].start[0]	2015-05-11
Organization.extension[0].extension[3].url[0]	https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod
Organization.extension[0].extension[4].url[0]	active
Organization.extension[0].extension[4].value[0]	True
Organization.extension[0].url[0]	https://fhir.nhs.uk/England/StructureDefinition/Extension-England-OrganisationRole
Organization.extension[1].extension[0].url[0]	type
Organization.extension[1].extension[0].value[0].system[0]	https://fhir.nhs.uk/England/CodeSystem/England-ODSDateTime
Organization.extension[1].extension[0].value[0].code[0]	LastChangeDate
Organization.extension[1].extension[0].value[0].display[0]	Last Change Date
Organization.extension[1].extension[1].url[0]	dateTime
Organization.extension[1].extension[1].value[0]	2020-09-24
Organization.extension[1].url[0]	https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedDateTime
Organization.identifier[0].use[0]	official
Organization.identifier[0].system[0]	https://fhir.nhs.uk/Id/ods-organization-code
Organization.identifier[0].value[0]	FDC49
Organization.identifier[0].assigner[0].display[0]	NHS BUSINESS SERVICES AUTHORITY
Organization.active[0]	True
Organization.type[0].coding[0].system[0]	https://fhir.nhs.uk/England/CodeSystem/England-ODSRecordUseType
Organization.type[0].coding[0].code[0]	Full
Organization.type[0].coding[0].display[0]	Full
Organization.type[1].coding[0].system[0]	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSRecordClass
Organization.type[1].coding[0].code[0]	RC1
Organization.type[1].coding[0].display[0]	HSCOrg
Organization.name[0]	ATOS MEDICAL
Organization.telecom[0].system[0]	phone
Organization.telecom[0].value[0]	01157 841906
Organization.address[0].line[0]	LONGFIELDS COURT
Organization.address[0].line[1]	WHARNCLIFFE BUSINESS PARK
Organization.address[0].city[0]	BARNSLEY
Organization.address[0].postalCode[0]	S71 3GN
Organization.address[0].country[0]	ENGLAND

XML View

<Organization xmlns="http://hl7.org/fhir">
    <id value="ODS-Organization-FDC49-Example" />
    <extension url="https://fhir.nhs.uk/England/StructureDefinition/Extension-England-OrganisationRole">
        <extension url="instanceID">
            <valueInteger value="231843" />
        </extension>
        <extension url="roleCode">
            <valueCodeableConcept>
                <coding>
                    <system value="https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSOrganisationRole" />
                    <code value="RO94" />
                    <display value="APPLIANCE CONTRACTOR" />
                </coding>
            </valueCodeableConcept>
        </extension>
        <extension url="https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod">
            <extension url="dateType">
                <valueCoding>
                    <system value="https://fhir.nhs.uk/England/CodeSystem/England-PeriodType" />
                    <code value="Legal" />
                    <display value="Legal" />
                </valueCoding>
            </extension>
            <extension url="period">
                <valuePeriod>
                    <start value="2015-05-11" />
                </valuePeriod>
            </extension>
        </extension>
        <extension url="https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod">
            <extension url="dateType">
                <valueCoding>
                    <system value="https://fhir.nhs.uk/England/CodeSystem/England-PeriodType" />
                    <code value="Operational" />
                    <display value="Operational" />
                </valueCoding>
            </extension>
            <extension url="period">
                <valuePeriod>
                    <start value="2015-05-11" />
                </valuePeriod>
            </extension>
        </extension>
        <extension url="active">
            <valueBoolean value="true" />
        </extension>
    </extension>
    <extension url="https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedDateTime">
        <extension url="type">
            <valueCoding>
                <system value="https://fhir.nhs.uk/England/CodeSystem/England-ODSDateTime" />
                <code value="LastChangeDate" />
                <display value="Last Change Date" />
            </valueCoding>
        </extension>
        <extension url="dateTime">
            <valueDateTime value="2020-09-24" />
        </extension>
    </extension>
    <identifier>
        <use value="official" />
        <system value="https://fhir.nhs.uk/Id/ods-organization-code" />
        <value value="FDC49" />
        <assigner>
            <display value="NHS BUSINESS SERVICES AUTHORITY" />
        </assigner>
    </identifier>
    <active value="true" />
    <type>
        <coding>
            <system value="https://fhir.nhs.uk/England/CodeSystem/England-ODSRecordUseType" />
            <code value="Full" />
            <display value="Full" />
        </coding>
    </type>
    <type>
        <coding>
            <system value="https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSRecordClass" />
            <code value="RC1" />
            <display value="HSCOrg" />
        </coding>
    </type>
    <name value="ATOS MEDICAL" />
    <telecom>
        <system value="phone" />
        <value value="01157 841906" />
    </telecom>
    <address>
        <line value="LONGFIELDS COURT" />
        <line value="WHARNCLIFFE BUSINESS PARK" />
        <city value="BARNSLEY" />
        <postalCode value="S71 3GN" />
        <country value="ENGLAND" />
    </address>
</Organization>

JSON View

{
    "resourceType": "Organization",
    "id": "ODS-Organization-FDC49-Example",
    "extension":  [
        {
            "url": "https://fhir.nhs.uk/England/StructureDefinition/Extension-England-OrganisationRole",
            "extension":  [
                {
                    "url": "instanceID",
                    "valueInteger": 231843
                },
                {
                    "url": "roleCode",
                    "valueCodeableConcept": {
                        "coding":  [
                            {
                                "system": "https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSOrganisationRole",
                                "code": "RO94",
                                "display": "APPLIANCE CONTRACTOR"
                            }
                        ]
                    }
                },
                {
                    "url": "https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod",
                    "extension":  [
                        {
                            "url": "dateType",
                            "valueCoding": {
                                "system": "https://fhir.nhs.uk/England/CodeSystem/England-PeriodType",
                                "code": "Legal",
                                "display": "Legal"
                            }
                        },
                        {
                            "url": "period",
                            "valuePeriod": {
                                "start": "2015-05-11"
                            }
                        }
                    ]
                },
                {
                    "url": "https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedPeriod",
                    "extension":  [
                        {
                            "url": "dateType",
                            "valueCoding": {
                                "system": "https://fhir.nhs.uk/England/CodeSystem/England-PeriodType",
                                "code": "Operational",
                                "display": "Operational"
                            }
                        },
                        {
                            "url": "period",
                            "valuePeriod": {
                                "start": "2015-05-11"
                            }
                        }
                    ]
                },
                {
                    "url": "active",
                    "valueBoolean": true
                }
            ]
        },
        {
            "url": "https://fhir.nhs.uk/England/StructureDefinition/Extension-England-TypedDateTime",
            "extension":  [
                {
                    "url": "type",
                    "valueCoding": {
                        "system": "https://fhir.nhs.uk/England/CodeSystem/England-ODSDateTime",
                        "code": "LastChangeDate",
                        "display": "Last Change Date"
                    }
                },
                {
                    "url": "dateTime",
                    "valueDateTime": "2020-09-24"
                }
            ]
        }
    ],
    "identifier":  [
        {
            "use": "official",
            "system": "https://fhir.nhs.uk/Id/ods-organization-code",
            "value": "FDC49",
            "assigner": {
                "display": "NHS BUSINESS SERVICES AUTHORITY"
            }
        }
    ],
    "active": true,
    "type":  [
        {
            "coding":  [
                {
                    "system": "https://fhir.nhs.uk/England/CodeSystem/England-ODSRecordUseType",
                    "code": "Full",
                    "display": "Full"
                }
            ]
        },
        {
            "coding":  [
                {
                    "system": "https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSRecordClass",
                    "code": "RC1",
                    "display": "HSCOrg"
                }
            ]
        }
    ],
    "name": "ATOS MEDICAL",
    "telecom":  [
        {
            "system": "phone",
            "value": "01157 841906"
        }
    ],
    "address":  [
        {
            "line":  [
                "LONGFIELDS COURT",
                "WHARNCLIFFE BUSINESS PARK"
            ],
            "city": "BARNSLEY",
            "postalCode": "S71 3GN",
            "country": "ENGLAND"
        }
    ]
}