Skip to main content
The Website Services team at NHS England are testing early designs to understand how you find information. Your views will help us check our ideas work. Sign up to take part in our user research.

Release APIM-R-1.40 - 21 January 2025

Find out about the NHS e-Referral Service (e-RS) API release.

This feature went live in APIM Release 1.40 (21 January 2025).

The information below was correct at the time of release.


1.0 Retrieve referral worklist

This update makes a change to the referrer worklist endpoint: Retrieve referral worklist (A008).

The change will allow partners to retrieve the 'Appointment Slot Issues' (ASI) worklist via the application-restricted, unattended access mode.

There are some caveats with this security pattern. The service filter is mandatory, and you must restrict worklist retrieval to two times a day, per service.


2.0 Enforcement of FHIR instant datatype

We have identified that the e-RS API does not strictly enforce fields using the FHIR instant datatype.

FHIR documentation defines the instant datatype as: “An instant in time - known at least to the second and always includes a time zone.”

The API currently accepts FHIR instant values that:

  • do not have a time component
  • have a date and time but are missing the time zone

As part of this release, the API will begin rejecting FHIR instant values without a time component.

Later in 2025, it will also reject FHIR instant values that lack a time zone.

Last edited: 4 March 2025 11:38 am