Skip to main content
Table of contents

Personal Demographics Service - FHIR API


Use this API to access the Personal Demographics Service (PDS) - the national electronic database of NHS patient details such as name, address, date of birth, related people and NHS Number.

You can:

  • search for patients
  • get patient details
  • update patient details

You cannot currently use this API to:

  • check that you have the right NHS Number for a patient (but you can achieve this indirectly using search for patient or get patient details)
  • create a new record for a birth
  • receive birth notifications
  • create a record for a new patient
  • register a new patient at a GP Practice - instead, use NHAIS GP Links API

You can read and update the following data:

  • NHS Number (read only)
  • name
  • gender
  • addresses and contact details
  • birth information
  • death information
  • registered GP
  • nominated pharmacy
  • dispensing doctor pharmacy
  • medical appliance supplier pharmacy
  • related people, such as next of kin (read only - update coming soon)

Currently, this API can only be accessed by healthcare professionals, authenticated with an NHS smartcard or equivalent. Unauthenticated access and citizen access are on the roadmap.


Personal Demographics Service - FHIR API documentation