What information will I receive when using HMRC Self Assessment APIs?

Article ID: 2754
Last updated: 06 Nov, 2017

HMRC have 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
  • 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
    •  Confirm if the maximum contributions 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 therefore ensure that you check the documentation received and make any corrections necessary before submitting the Tax Return to HMRC.

Article ID: 2754
Last updated: 06 Nov, 2017
Revision: 4
Views: 2360
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