Guidance

Outgoing Data Provisioning Service: technical specifications

Data Provisioning Service technical specifications for software developers, including tax code, student loan and generic notifications.

• From: HM Revenue & Customs
• Published: 30 November 2007
• Last updated: 15 September 2025
  Show all updates

  1. 15 September 2025

     'DPS outgoing schemas: version 2.92' has been replaced with 'DPS outgoing schemas: version 2.93'.

  2. 22 September 2022

     The supplementary guidance has been updated from version 2.7 to version 2.8.

  3. 1 September 2020

     DPS outgoing schemas has been updated to version 2.92.

  4. 7 December 2018

     DPS API specification updated to version 3.0, supplementary guidance updated to version 2.7, outgoing schemas updated to version 2.91 and stylesheets updated to version 10.0.

  5. 15 March 2018

     Data Provisioning Service API specification updated to version 1.9, for minor wording changes.

  6. 3 October 2017

     Supplementary guidance updated to version 2.6.

  7. 20 February 2017

     DPS stylesheets updated to version 9.0.

  8. 24 January 2017

     DPS Outgoing Schemas updated to version 2.9.

  9. 3 October 2016

     DPS Outgoing Schemas v2-8 added to the page.

  10. 30 March 2015

      The DPS API specification and Supplementary guidance and how to use the DPS test service documents have been updated.

  11. 24 December 2014

      DPS outgoing schemas 2.7 has been added to the page.

  12. 23 December 2014

      DPS API specification 1.7, DPS stylesheets 8.0, and DPS outgoing schemas 2.6 have been added to the page.

  13. 30 November 2007

      First published.

Documents

DPS API specification: version 3.0

PDF, 516 KB, 21 pages

Supplementary guidance and how to use the DPS test service: version 2.8

ODT, 36.6 KB

This file is in an OpenDocument format

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

DPS WSDLs: version 1.1

ZIP, 2.35 KB

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

DPS outgoing schemas: version 2.93

ZIP, 25.5 KB

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Generic notification schemas: version 1.0

ZIP, 5.47 KB

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

Response error messages: version 1.1

PDF, 26.1 KB, 6 pages

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

DPS sample data: version 1.1

ZIP, 1.46 KB

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

DPS stylesheets: version 10.0

http://www.hmrc.gov.uk/gds/ebu/paye_techpack/dps-stylesheets-v10-0.zip

Details

Use these Data Provisioning Service technical specifications relevant to tax code, student loan and generic notifications if you’re a software developer.

Related guidance

Outgoing Data Provisioning Service: Outgoing XML Generator
Use this tool if you are a software developer wanting to produce user-defined XML test scenarios.