Guidance

Self Assessment technical specifications (2024) for individual returns

Use this technical documentation for individual returns if you're a software developer working with the Self Assessment online service.

Documents

Self Assessment Individual RIM artefacts version 1.0

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.

Tax and NIC calculation version 2.0.0a

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.

Stage 13 (Payments on account) Tax and National Insurance contributions calculation version 1.0.0a

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.

MTR Test Case Generator (Tester) version 2.0.1

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.

MTR Mapping version 1.0

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.

Special cases version 1.0a

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.

Exclusion cases version 1.0a

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.

Details

You should use this technical documentation for individual returns if you’re a software developer working with the Self Assessment online service.

Published 20 October 2023
Last updated 22 April 2024 + show all updates
  1. Special cases version 1.0a has replaced Special cases version 0.1a. Exclusion cases version 1.0a has replaced Exclusion cases version 0.1a.

  2. MTR Test Case Generator (Tester) version 2.0.0 has replaced MTR Test Case Generator (Tester) version 2.0.1.

  3. Self Assessment technical specifications 'Special cases version 0.1a' and 'Exclusion cases version 0.1a' have been added.

  4. Tax and NIC calculation version 2.0.0a has replaced Tax and NIC calculation version 1.4.0a and MTR Test Case Generator (Tester) version 2.0.0 has replaced MTR Test Case Generator (Tester) version 1.4.1.

  5. MTR Test Case Generator (Tester) version 1.4.1 has replaced MTR Test Case Generator (Tester) version 1.4.0.

  6. Tax and NIC calculation version 1.4.0a and MTR Test Case Generator (Tester) version 1.4.0 have been updated. MTR Mapping version 1.0 has been added to the page.

  7. First published.