Deprecation notices
The latest news on deprecated features and associated migration guides for the NHS e-Referral Service API.
Overview
This page is updated periodically to communicate important decisions concerning features for deprecation.
Each deprecation notice documents the removal of features and provides alternatives, in the form of a migration guide, to minimise business disruptions.
Notices
| Feature | Deprecation notice | Deprecation date | Retirement date | Migration guide |
|---|---|---|---|---|
|
HSCN FHIR API/CIS1 |
February 2023 | August 2023 | February 20271 | Migrating from HSCN/CIS1 to APIM/CIS2 |
|
FHIR DSTU2 endpoints |
November 2022 | August 2023 | February 20271 | Migrating from FHIR DSTU2 to FHIR STU3 |
| Send for triage endpoints | June 2023 | March 2024 | March 2025 | Migrating from the send for triage endpoints to the book/defer endpoint |
| File attachments (Release 1) | January 2025 | February 2025 | February 2026 | |
| File attachments (Release 3) | September 2026 | September 2026 | September 2027 | Migrating to the FHIR R4 upload attachment endpoint |
1 The retirement date was delayed from August 2024. From March 2026, the DSTU2 endpoints and use of CIS1 will no longer have an SLA and will be supported on a 'reasonable endeavours' basis. From 28 February 2027, we will remove the DTSU2 endpoints and CIS1 authentication from our service, meaning it can no longer be used.
Last edited: 10 September 2026 2:58 pm