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