v1

latestOpenAPI 3.0.32026-07-131412.0 KB
national-insurance

Get National Insurance annual summary

Fetches an individual’s National Insurance contributions for the given tax year.

get/national-insurance/sa/{utr}/annual-summary/{taxYear}

Path parameters

utrstring required
Example:2234567890

The 10 digit self-assessment UTR for the individual.

taxYearstring required
Example:2014-15

The tax year for the National Insurance Contribution being retrieved.

Headers

Accept'application/vnd.hmrc.1.1+json' required

Specifies the response format and the version of the API to be used.

Authorizationstring required
Example:Bearer bb7fed3fe10dd235a2ccda3d50fb

An OAuth 2.0 Bearer Token with the read:national-insurance scope.

Response

OK

maxNICsReachedboolean required

A flag indicating whether the maximum National Insurance contributions has been reached

Example response

{
  "class1": {
    "totalNICableEarnings": 10
  },
  "class2": {
    "totalDue": 20
  }
}
All 1 operations