Search loading...


Explore and Make use of Nationally Defined Messaging APIs


Retrieval Provider Guidance

Provider requirements and guidance for record and document retrieval.

HTTP Request

Retrieval of documents/records is achieved through an HTTP GET request. See the Retrieval Read Interaction page for details of the requirements for responding to an HTTP GET request for retrieval.

Provider Endpoint and Interaction ID registration

Endpoints for retrieval must be registered on the Spine Directory Service (SDS). For the Beta phase this will be done by the NHS Digital Deployment Issue and Resolution (DIR) team following completion of assurance. See the Spine Core specification for further detail on registering provider endpoints.

Providers MUST ensure that the record author ODS code on the pointer metadata matches the ODS code for the endpoint registered in SDS.

Providers MUST ensure that endpoints for retrieval are registered on SDS with the interaction ID urn:nhs:names:services:nrl:DocumentReference.content.

Fully Qualified Doman Name (FQDN)

Following completion of assurance, Providers will be supplied with an x509 Certificate and an FQDN. The FQDN will form the base of Provider Endpoints as detailed above. For further detail, see the Security page.

All content is available under the Open Government Licence v3.0, except where otherwise stated