Skip to main content

Query Accredited System Information - SOAP API

Access details of accredited systems in the Spine Directory Service (SDS) using this SOAP API.

This API is in production but deprecated.  It will be retired on 31st October 2024. For more details, see API status

If you are developing a new integration, consider using the Spine Directory Service - FHIR API instead. If you have any concerns, contact us


Use this API to search for details about accredited systems and the processes they support, known as interactions, which are held in the Spine Directory Service (SDS) repository. 

This API provides reference information on these accredited systems, along with details of how to interact with these systems. For example, use this API to retrieve the details of the API endpoint to which a PDS update message can be sent.

Use this API to:

  • search for and obtain information on accredited systems such as their accredited system identifier (ASID) and associated messaging endpoint information.
  • verify whether a specific accredited system is able to handle a specified interaction.

For more details, see the Spine External Interface Specification (EIS) Part 5 - Spine Directory Services (SDS).

Who can use this API

This API 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). 

API status and roadmap

As of 7 July 2022, this API is in production but deprecated, meaning:

  • it is still available for use
  • full service levels still apply
  • we are unlikely to make any updates to it
  • new integrations are not allowed - although in-flight integrations can continue

This API will be retired on 31st October 2024, so if you have any concerns, contact us

The Spine Directory Service - FHIR API now provides equivalent functionality. For details, see our interactive product backlog.

Service level

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

For more details, see service levels.


This API is accessed via a SOAP web service. 

For more details, see Basic SOAP.

Network access

You need a Health and Social Care Network (HSCN) connection to use this API.

For more details, see Network access for APIs.

Security and authorisation

For details, see part 5 of the Spine External Interface Specification.


You can test this API using our Path to Live environments.


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

This API is deprecated and is not available for new onboardings. If you have already started onboarding, you can continue, but be aware that this API will be retired on 31st October 2024.

It uses the Common Assurance Process (CAP) which is tailored for each NHS service.


For details of interactions for this API, see part 5 of the Spine External Interface Specification but with the following caveats.

EIS Part 5, sections 5.3, 5.19 and 5.20 describe the capability of the QASI API to provide compatible matches in addition to exact matches to searches for accredited systems. We achieved this through advanced server components which implemented business logic to

  • traverse hierarchical organisation data looking for matches in parent organisations
  • use internal lookup tables to provide compatible interactions where a message transformation could be carried out by the server.

The current implementation of the QASI API removes all these capabilities and now only provides exact matches.

Last edited: 14 September 2023 5:16 pm