Skip to main content

Directory of Services - Urgent and Emergency Care - SOAP API

Access information on a wide range of health and care services across England using our Directory of Services (DoS) Urgent and Emergency Care SOAP API.


Use this API to access Directory of Services (DoS) information on a wide range of health and care services across England. 

You can search for services based on a combination of parameters: 

  • find an appropriate list of services for a specific clinical need
  • get technical endpoint information for a given service, using a service ID or ODS code
  • obtain capacity information for specified hospitals or wards, using a service ID or ODS code

This service is widely used in an Urgent and Emergency Care context using NHS Pathways outcomes. For example, NHS 111 use it to find a service in real-time with the capacity to help a patient with given symptoms, within range of a given location.

You need a valid DoS account to use this API.

For a non-technical overview of how to build software that deals with:

Who can use this API

This API can only be used where there is a legal basis to do so. Make sure you complete an access request form before you go too far with your development. See our acceptable use policy for more details.

You must have made this request before you can go live (see 'Onboarding' below).

API status

This API is in production.

Service level

This API is a gold service, meaning it is operational and supported 24 hours a day, 365 days a year.

For more details, see service levels.


This API is a SOAP API. 

For more details, see Basic SOAP.

We also have a Directory of Services - Urgent and Emergency Care - REST API available.

Network access

This API is available on the internet and, indirectly, on the Health and Social Care Network (HSCN).

For more details, see Network access for APIs.

Security and authorisation

You need a valid DoS account to use this API.

This API uses HTTP basic authentication. We use authentication to track API usage and to control which information is returned to a search.

HTTP basic authentication is built in to all HTTP clients and requires the Authorization request header with the DoS username and password colon delimited and base64 encoded.

Environments and testing

For details of testing and production (live) environments, see Environments Overview.


You must get your software onboarded before it can go live.

As part of onboarding, you must submit an access request and email it to the DoS live service team, see Request for access to our urgent and emergency Care DoS.

Requests are subject to an application process including review by the DoS Steering Group.


For a full list of interactions, see the DoS SOAP API version 1.5.

Last edited: 21 November 2023 10:40 am