We have detected that you are using Internet Explorer to visit this website. Internet Explorer is now being phased out by Microsoft. As a result, NHS Digital no longer supports any version of Internet Explorer for our web-based products, as it involves considerable extra effort and expense, which cannot be justified from public funds. Some features on this site will not work. You should use a modern browser such as Edge, Chrome, Firefox, or Safari. If you have difficulty installing or accessing a different browser, contact your IT support team.
National Record Locator for developers
Provides resources to the code behind the NRL Demonstrator (interactive guide), further information around the code construct of the demonstrator, code examples of how to connect to the NRL, and access to a reference implementation (stub) of the NRL API for quick and easy testing.
Page contents
Technical specifications
This is the main resource for suppliers to develop against, as well as the specification for the NRL itself.
Reference implementation
Allows anyone to send requests and view responses with test data through a clone of the NRL API, without needing to worry about access to testing environments.
The Reference Implementation can be accessed using API-testing tools such as Postman. It also provides a simple user interface through which to test requests and responses, based on Swagger.
Demonstrator
The NRL Demonstrator Application is intended for both technical and non-technical audiences to quickly understand the basic functionality of the NRL.
The demonstrator shows how the NRL could look to a user of a consumer system, using the layout of the Summary Care Record application (SCRa) as an example.
Data and code
Data
The demonstration application and reference implementation use fictitious data. It is only a small set of data but can be added to easily. More information about what data can be used in the stub and how to rerun the data commands is available through the wiki.
Please note that data is cleared down every evening.
Code and Wiki
Source code and technical information about both the Reference Implementation and Demonstrator are available from the NRLS Reference Implementation GitHub repository and the Demonstrator wiki.
FHIR resources
To create FHIR server implementations and to help with generating, parsing, and validating FHIR resources, libraries are available in a variety of programming languages and frameworks. A number of these are listed on the HL7 Open Source FHIR implementations page.
Last edited: 16 September 2020 3:55 pm