Query Accredited System Information - SOAP API

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

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

The following APIs are related to this one:

• Spine Directory Service - LDAP API - access details of organisations, people and systems registered in the Spine Directory Service (SDS)
• Spine Directory Service - FHIR API - an internet-facing, FHIR-conformant API which might be a better way to access SDS for some use cases

This API is stable.

This API is accessed via a SOAP web service. 

For more details, see Basic SOAP.

You can access this API via:

• the Health and Social Care Network (HSCN)
• the internet

For more details, see Network access for APIs.

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.

As part of onboarding, this API uses the Common Assurance Process (CAP), which is tailored for each NHS service. For more details, contact us.

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.