Skip to main content

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.   

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.


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


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