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.
Overview
Use this API to submit ambulance data to our Data Processing Service (DPS) so that it can be made available for analysis and review by NHS England and ambulance trusts.
Ambulance analytics data is information relating to emergency calls (999, 111 and others), received at an Emergency Operations Centre (EOC) and processed into a Computer Aided Despatch (CAD) system, including:
- call details
- response details - including response times and episode outcome times patient
- contact details - including patient demographics, patient response details, patient information, injury information, patient assessment, medication, observations, diagnoses, conveying outcome, safeguarding and public health information
You can:
- post ambulance analytics data individually or in batches
You cannot:
- read any of the records stored in DPS
The API is asynchronous - to receive error notifications, you need to use MESH. The following diagram illustrates the end-to-end process:
The following describes the end-to-end process:
- the Ambulance Trust System sends the ambulance analytics data to the Ambulance Data Submission API
- the Ambulance Data Submission API forwards the ambulance analytics data to our Data Processing System (DPS)
- if there is an error, DPS sends an error notification to MESH
- the Ambulance Trust System retrieves the error notification from MESH
- an Analytics User views ambulance analytics data in our NHS Digital Analytics Dashboards
- the NHS Digital Analytics Dashboards get the ambulance analytics data from DPS
Legal Use
This API can only be used where there is a legal basis to do so. Make sure you have a valid use case before you go too far with your development. You must do this before you can go live (see ‘Onboarding’ below).
Related APIs
Use Messaging Exchange for Social care and Health (MESH) to receive error notifications from DPS for this API
API status and roadmap
This API is in private beta, meaning:
- we might make breaking changes, but only if we can't avoid it, and we'll give advance notice
- we can't guarantee availability or performance
- it is available for production use, but only to a small group of ambulance trusts in England
To see our roadmap, or to suggest, comment or vote on features for this API, see our interactive product backlog.
If you have any other queries, please contact us.
Technology
This API uses HTTP POST to submit data.
The data payload conforms to the FHIR global standard for health care data exchange. Specifically, it is aligned with FHIR UK Core, which is built on FHIR Release 4. To see the FHIR message payload, see the Ambulance Data Set FHIR Implementation Guide
Network access
This API is available on the internet and, indirectly, on the Health and Social Care Network (HSCN).
For more details, see Network access for APIs.
Security and authorisation
Application-restricted access
This access mode is application-restricted, meaning we authenticate the calling application but not the end user.
You can use this access mode as follows:
- unattended (end user not present), for example as part of a back end process to check NHS numbers for data flowing from one system to another
To use this access mode, use the following security pattern:
Sandbox testing
Our sandbox environment:
- is for early developer testing
- only covers a limited set of scenarios
- is stateless, so it does not actually persist any updates
- is open access, so does not allow you to test authorisation
For more details on sandbox testing, or to try out the sandbox using our "Try this API" feature, see the documentation for each endpoint.
Integration testing
Our integration test environment:
- is for formal integration testing
Onboarding
You need to get your software approved by us before it can go live with this API. We call this onboarding. The onboarding process can sometimes be quite long, so it’s worth planning well ahead.
To onboard for this API, follow the Supplier Conformance Assessment List (SCAL) process.
When following the SCAL process, note that:
- In step 8: you need to review and complete the Ambulance Data Submission API risk log to show that you have understood and mitigated the various risks. You might be asked to provide some evidence to prove that controls have been put in place. You’ll find the risk log embedded within the Ambulance Data Submission API tab in the SCAL.
- In step 10: when you complete the Service Desk Registration Form, send it to api.management@nhs.net.
- In step 11: submit your completed SCAL to api.management@nhs.net.
- In step 14: to request production access, contact us at api.management@nhs.net.
Endpoints: PostAmbulanceData
Submit Ambulance Data
Overview
Use this endpoint to submit ambulance data to DPS. This endpoint does not validate the submitted payload, it only acknowledges receipt of the payload. See the FHIR implementation guide for how to structure the payload data.
Response
HTTP status: 200
Body
{
"message" : "6eeec54e-3d39-4bc4-a1d9-57615d258fpq"
}
Name | Description |
---|---|
object
|
|
message string
|