Knowledgebase Support HMRC Useful links
Knowledgebase home
Tax Return Production
Accounts Production
Practice Management
VAT Filer
Anti-Money Laundering
Support home
Video Training Guides

Hot Topics
SimpleStep Guides
Release Notes
Known Issues

Service Status
Useful Links
What is MTD? Support for Accountants Support for Business
HMRC's MTD Timeline
Digital Requirements
TaxCalc's MTD Journey
MTD for Income Tax
MTD for Corporation Tax
MTD for Income Tax
MTD for Corporation Tax
Step-by-step Guide

What information will I receive when using Fetch Taxpayer Data (HMRC Self Assessment APIs)?

Article ID: 2754
Last updated: 05 Apr, 2023

HMRC has provided a method of sending information relevant to the completion of a Tax Return called Application Program Interfaces or APIs. This is the first part of their overall Digital transformation project known as Making Tax Digital.    

This allows TaxCalc to request information held by HMRC and pull it into the SA100 Tax Return. HMRC APIs provide the following information:

  • Employment income and tax deducted
    • Indication if employment is Off-Payroll working
  • Benefits in kind received from employment (P11D)
  • Pensions (not State pension)
  • Incapacity benefit
  • Jobseekers allowance
  • SEISS claimed (2021 and 2022)
  • Tax refunded or set off by HMRC
  • Marriage allowance status 
    • Confirm if the individual is claiming as a transferor or recipient of the allowance
  • Marriage allowance eligibility
    • HMRC will confirm if an individual is eligible to make a claim
  • National insurance -
    • Total Class 1 earnings between the primary threshold and upper limit. 
    • Total charge due for Class 2
    •  Confirms if the maximum contribution has been reached for the year   

Please note that if no information is received but should be received or the information is incorrect then it is likely that HMRC do not have the correct records relating to the individual taxpayer. Please ensure that you check the documentation received and make any corrections necessary before submitting the Tax Return to HMRC.

The data on HMRC's system is available for use within the API function for approximately 2 years. If you were trying to use the fetch facility for returns from 2021 or before, this is likely to return an error and the details would need to be manually entered on the return. If the taxpayer holds a Personal Tax Account then details can be obtained via this method which may encompass details going back to 2017.

Article ID: 2754
Last updated: 05 Apr, 2023
Revision: 8
Views: 4474
This article was:  

Also read
item What is the HMRC API?
item How to use HMRC Self assessment APIs for practice

Also listed in
folder Tax Return Production -> SA100 Individual Return