---
title: "Create National Insurance summary test data"
method: POST
path: "/national-insurance-test-support/sa/{utr}/annual-summary/{taxYear}"
---

# Create National Insurance summary test data

`POST /national-insurance-test-support/sa/{utr}/annual-summary/{taxYear}`

## Request

- Base URL: `https://test-api.service.hmrc.gov.uk`
- URL: `https://test-api.service.hmrc.gov.uk/national-insurance-test-support/sa/{utr}/annual-summary/{taxYear}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://test-api.service.hmrc.gov.uk/oauth/token`

Lets you create National Insurance contributions test data

## Path parameters

- `utr` string, required
- `taxYear` string, required

## Headers

- `Accept` 'application/vnd.hmrc.1.0+json', required
- `Content-Type` 'application/json', required
- `Authorization` string, required

## Request body

- object: Create National Insurance summary test data request

## Response `201`

Created

- object: Create National Insurance summary test data response
  - `class1` object, required
    - `totalNICableEarnings` number, required: Total Class 1 earnings subject to National Insurance contributions between the Primary Threshold and the Upper Earnings Limit
  - `class2` object, required
    - `totalDue` number, required: Total Class 2 National Insurance contributions due
  - `maxNICsReached` boolean, required: A flag indicating whether the maximum National Insurance contributions has been reached

---

[API](https://skmtc.dev/hmrc/apis/national-insurance-des-stub.md) - [All operations](https://skmtc.dev/hmrc/apis/national-insurance-des-stub/llms.txt) - [OpenAPI document](https://skmtc.dev/hmrc/apis/national-insurance-des-stub/revisions/9cb6a4f2919d?raw)