Skip to main content

Demographics Batch Service API

Submit a file of patient information to the Spine for tracing against the Personal Demographics Service (PDS).

Overview

Use this API to submit a file of patient information to the Spine for tracing against the Personal Demographics Service (PDS) for direct care purposes.

The service is provided for organisations that do not want to write their own software - typically NHS trusts or local authorities.

It returns a limited set of PDS data items, as for PDS SMSP.

You can:

  • install a DBS client in a secure location, for example in a server room not a desktop PC
  • complete the DBS End Point Registration form (XLS, 67.5kB) and submit it to the DBS Implementation Team at demographics@hscic.gov.uk. You should receive endpoint information within 7 days.
  • submit a test file to DBS to confirm connectivity over Secure FTP
  • use the DBS client to submit batch trace requests and receive batch responses to them

DBS requires a secure network connection. It is an offline service so does not require smartcards.

API status

This API is stable.

Technology

DBS accepts fixed length text files or comma separated variable (CSV) files via the DBS client.

The DBS client is a Secure File Transfer Protocol (SFTP) client that sends a specifically formatted file to the Spine which is then used to interrogate PDS. DBS notifies the DBS client user when a response is available, who can then receive the response file.

Interactions

For a full list of interactions for this API, see the DBS User Guide under Additional guidance.

Additional guidance

DBS User Guide

This is a Portable Document Format file. To request a different format, contact us

  • internal
Last edited: 12 February 2021 5:20 pm