Skip to main content
Personal Demographics Service Notifications - FHIR API

Receive notifications about changes to a patient's demographic details, including birth, death, change of address and change of GP.


Use this API to receive notifications about changes to a patient's demographic details, including:

  • birth notifications
  • death notifications
  • change of address
  • change of GP

We share information about these events, using a publication-subscription model, with healthcare workers in other organisations such as GPs, Emergency Departments and Local Authorities. To receive these notifications you'll need to subscribe to them via National Events Management Service (NEMS).

For example, when we update Personal Demographics Service (PDS) with a birth, PDS sends a birth notification event containing information about the birth to NEMS. NEMS then sends the event to all healthcare workers who have subscribed to receive birth notifications.

API status

This API is stable.


This API uses a publish-subscribe model.

Use our National Events Management Service (NEMS) API to subscribe for events.

Use our MESH API to collect events that you have subscribed to.

The message payload uses FHIR STU3.


For a full list of interactions for this API, see:

For details on the general structure of the interactions, see FHIR.

Last edited: 6 September 2021 2:29 pm