Skip to main content

Death notification event

This event notifies subscribers when a patient’s death is registered via the Multicast Notification Service API (MNS).

To subscribe to this event, use the Create Subscriptions API documentation.

Understanding events

Events inform subscribers of a particular type of change that has occurred in the event publishing service. 


Event name

pds-death-notification-2


Event trigger

This event is triggered when a patient’s death status in Personal Demographics Service (PDS) is changed.


Events status

This event is currently in private beta.


Event schema

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

Supported formats: 

  • FHIR R4

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


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. Details of events published by the Personal Demographics Service are retrieved:


Event subscription filtering

When subscribing to an event, it is possible to define notification filters; for example, ‘only notify me of events for a specific ODS number, or NHS number’.

This event currently has no filtering capability.

 


Versions

  • pds-death-notification-2 (latest)
    • FHIR R4
  • pds-death-notification-1 (deprecated)
    • CloudEvent

Last edited: 7 May 2026 2:00 pm