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

Article ID: 2754
Last updated: 21 Mar, 2024

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
  • 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 2022 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: 21 Mar, 2024
Revision: 9
Views: 5188
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