National Insurance categories can be assigned to an employment to control how National Insurance contributions are calculated for an employee
Add National Insurance Category
Assigns a National Insurance category to an employment. This endpoint creates a NI category assignment record linking the employment to the specified NI category code.
SecuritybearerAuth
Request
Responses
201
National Insurance Category Response
post/employments/{employmentId}/nicategory
Request samples
- Payload
- curl
- C#
- Java
- PHP
application/vnd.api+json
{- "data": {
- "type": "nationalInsuranceCategories",
- "attributes": {
- "employmentId": "f78c7fbf-ae0e-7632-0993-d34629ef5081",
- "startDate": "2025-01-15",
- "niCategory": "X"
}
}
}Response samples
- 201
application/vnd.api+json
{- "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03",
- "data": {
- "type": "nationalInsuranceCategories",
- "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
- "attributes": {
- "employmentId": "f78c7fbf-ae0e-7632-0993-d34629ef5081",
- "startDate": "2025-01-15",
- "niCategory": "X"
}
}
}