Skip to main content

Digital health checks event

This event notifies subscribers that a health check has been completed for a patient and is now available in Patient Data Manager (PDM) using the Multicast Notification Service (MNS).

Overview

This event notifies subscribers that a health check has been completed for a patient and is now available in Patient Data Manager (PDM) using the Multicast Notification Service (MNS).

  • Publisher: Digital Health Checks
  • Event name: nhshco-hc-complete-1
  • Delivery mechanism: MNS
  • Payload type: Notification (event only)
  • Data retrieval: PDM

For general guidance on using MNS, refer to the MNS service page.


Events status

This event is currently in development.


When should I use this event?

This event notifies subscribers when new health check data has been written back to PDM.

Example use cases

The Digital Health Check event is designed to let GP practices know that a health check has been completed for one of their patients. 

When should I not use this event?

This event is is not suitable for subscribers wanting to know about changes in a patient's demographic data.


How it works

This event follows a notification and retrieval pattern:

  1. A Digital Health Check record is updated in Patient Data Manager (PDM).

  2. An event is published.

  3. A notification is sent to subscribed systems.

  4. The subscribed system receives the notification.

  5. The subscribed system calls Patient Data Manager API using the notification filters specified.

  6. The subscribed system retrieves and applies the latest data.


Event trigger

This event is triggered when a health check is stored within PDM.


Event schema

Subscribers can choose to receive a notification of an event in their preferred format. This is specified when creating a subscription.

Formats differ in their presentation only; the content is the same. 

Example FHIR event

{
    "resourceType": "Bundle",
    "id": "236a1d4a-5d69-4fa9-9c7f-e72bf505aa5b",
    "type": "history",
    "timestamp": "2025-04-05T17:31:00.000Z",
    "entry": [
        {
            "fullUrl": "urn:uuid:e45ae8eb-1e11-4c7f-a18d-868c0a984633",
            "resource": {
                "resourceType": "Parameters",
                "meta": {
                    "profile": [
                        "http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-subscription-status-r4"
                    ]
                },
                "id": "e45ae8eb-1e11-4c7f-a18d-868c0a984633",
                "parameter": [
                    {
                        "name": "subscription",
                        "valueReference": {
                            "reference": "https://api.service.nhs.uk/multicast-notification-service/subscriptions"
                        }
                    },
                    {
                        "name": "status",
                        "valueCode": "active"
                    },
                    {
                        "name": "type",
                        "valueCode": "event-notification"
                    },
                    {
                        "name": "notification-event",
                        "part": [
                            {
                                "name": "event-number",
                                "valueString": "1"
                            },
                            {
                                "name": "timestamp",
                                "valueInstant": "2025-04-05T17:31:00.000Z"
                            },
                            {
                                "name": "focus",
                                "valueReference": {
                                    "reference": "https://int.api.service.nhs.uk/patient-data-manager/FHIR/R4/Composition/b0b97bff-e3d7-4744-a09a-e55781886dd0/$document"
                                }
                            }
                        ]
                    },
                    {
                        "name": "additional-context",
                        "part": [
                            {
                                "name": "event-type",
                                "valueString": "nhshco-hc-complete-1"
                            },
                            {
                                "name": "source",
                                "valueUri": "uk.nhs.nhs-health-check-online"
                            },
                            {
                                "name": "subject",
                                "valueReference": {
                                    "identifier": {
                                        "value": "9912003888"
                                    }
                                }
                            }
                        ]
                    }
                ]
            },
            "request": {
                "method": "GET",
                "url": "https://api.service.nhs.uk/multicast-notification-service/subscriptions"
            },
            "response": {
                "status": "200"
            }
        }
    ]
}

CloudEvent example

{
    "specversion": "1.0",
    "id": "236a1d4a-5d69-4fa9-9c7f-e72bf505aa5b",
    "type": "nhshco-hc-complete-1",
    "subject": "9912003888",
    "source": "uk.nhs.nhs-health-check-online",
    "time": "2025-04-05T17:31:00.000Z",
    "dataref": "https://int.api.service.nhs.uk/patient-data-manager/FHIR/R4/Composition/b0b97bff-e3d7-4744-a09a-e55781886dd0/$document"
}

Get event details

Subscribers must typically use a synchronous API of the event publishing service to retrieve full details of the event or change. 

Event notifications contain information to facilitate this. This may be a URL pointing to a RESTful FHIR resource or some other identifier meaningful to the source system.

Publishing services may have more than one API available to retrieve this information.

The API catalogue entry for NHS health checks online is pending.


Event subscription filtering

You can filter the events you want to receive using the criteria field in the subscription payload. You should only be subscribing to events you need to receive and must not create filters wider than required.

Available filters

Filter name Filter subscription type Description
gppractice ODS code ODS code of the GP practice where the subject is registered
status status code Status of the Health Check record to which the update relates. One of preliminary, final , amended or entered-in-error 

 


Testing

This event is available to test in the Path to Live (PTL) environments.


Versions

This is the first and only version of this event.


Contact us

For help and support subscribing to this event and to join our developer community, see Help and support building healthcare software.

Last edited: 13 November 2026 9:42 am