Search loading...

API Hub

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 more details 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 X.509 Certificate and an FQDN. The FQDN will form the base of Provider Endpoints as detailed above. For more details, see the Security page.


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