Service Search API - versions 1 and 2

Use this API to find information about NHS services, including lists of NHS organisation types, organisations, and coronavirus (COVID 19) walk-in sites.

• search for NHS organisation types, for example, GP practices, hospitals

• search for NHS organisations that provide services listed in NHS service near you, for example, Leeds General Infirmary

• search for coronavirus (COVID 19) walk-in sites

These APIs can only be used where there is a legal basis to do so. Make sure you have a valid use case before you go too far with your development. 

You must do this before you can go live (see 'Onboarding' below).

The following APIs are related to this API:

• Directory of Services - Urgent and Emergency Care - SOAP API - use this SOAP API to access information on a wide range of health and care services across England
• Directory of Services - Urgent and Emergency Care - REST API - use this REST API to access information on a wide range of health and care services across England
• EPS Directory of Services - REST API - use this to access information about dispensing services, including searching for dispensers who can provide services for a patient with a given location and urgency
• Electronic Transmission of Prescriptions Web Services - SOAP API - use this to access EPS dispenser (and dispensing appliance contractor) information for a patient via NHS UK Web Services
• e-Referral Services - A010 Patient service search endpoint - use this endpoint to find services that meet the referral needs of a patient

This API is in production.

This API is a bronze service, meaning it is operational and supported only during business hours (8am to 6pm), Monday to Friday excluding bank holidays.

For more details, see service levels.

The API is RESTful.

The API supports search using either HTTP GET or HTTP POST.

It is not hosted on our API platform. 

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.

This API is application-restricted, meaning we authenticate the calling application but not the end user.

Your request must include a subscription-key header with a valid subscription key. Login or register with the NHS website developer portal to get your subscription key.

For more details, see getting started.

For further details on interactions, see:

• organisation types (version 1)

• organisations (version 1)

• organisations (version 2)

• coronavirus (COVID 19) walk-in sites (version 1)

• coronavirus (COVID 19) walk-in sites (version 2)