API

Request Type	URL
GET	/v1/ValueSet/{valueSetId}

Description

This read-only API lets a user access a pre-populated list of reference data. The NHS e-Referral Service uses these lists throughout. For example, a list of specialities. They support data accuracy and effective re-use. It retrieves a specific Value Set (Reference Dataset) by ID.

Input

Applicable values for the {valueSetId}:

Value Set ID	Description
REQUEST_PRIORITY	Request Priorities defined in e-RS.
SPECIALTY	Specialties defined in e-RS. Also returns applicable Clinic Types as sub-concepts (categorized by Specialty).
CLINIC_TYPE	Clinic Types defined in e-RS.
REQUEST_TYPE	Request Types defined in e-RS.
COMMISSIONING_TYPE	Commissioning Types defined in e-RS.

Header

Provide ASID of the end-point system and equivalent Session Key generated for the SSO Token-ID.

Example

XAPI_ASID:200000000220
Content-Type:application/json+fhir
HTTP_X_SESSION_KEY:{sessionKey}

Output

A Value Set Resource profiled specifically for the given valueSetId. This will include the requested coding system with its available codes. The response code 200 (OK) is returned.

Example

{
    "id": "SPECIALTY",
    "meta": {
        "profile": [
            "http://fhir.nhs.uk/StructureDefinition/ers-valueset-1"
        ]
    },
    "resourceType": "ValueSet",
    "status": "active",
    "publisher": "HSCIC",
    "date": "2017-07-28",
    "description": "Specialties defined in e-RS",
    "codeSystem": {
        "system": "http://fhir.nhs.uk/ValueSet/ers-specialty-1",
        "concept": [
            {
                "extension": [
                    {
                        "url": "http://fhir.nhs.uk/StructureDefinition/extension-ers-effectivefromdate-1",
                        "valueDateTime": "2004-06-01T00:00:00.000Z"
                    }
                ],
                "code": "2WW",
                "display": "2WW",
                "designation": {
                    "value": "9901"
                }
            },

            {
                "extension": [
                    {
                        "url": "http://fhir.nhs.uk/StructureDefinition/extension-ers-effectivefromdate-1",
                        "valueDateTime": "2004-06-01T00:00:00.000Z"
                    }
                ],
                "code": "UROLOGY",
                "display": "Urology",
                "designation": {
                    "value": "101"
                }
            }
        ]
    }
}

Notes

Consuming application must have a valid session in order to access this endpoint.