---
title: "Changes to Retrieve applicable surcharges for a registration period"
method: POST
path: "/public/surcharges/v1/retrieve-surcharges"
---

# Changes to Retrieve applicable surcharges for a registration period

`POST /public/surcharges/v1/retrieve-surcharges`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 14 revisions.

- **2026-09-29** `f9510f3f4b22`: 5 breaking, 4 info
- **2026-09-29** `3352b56bb8fe`: 3 breaking, 6 warning, 4 info
- **2026-09-16** `ccf9834e5006`: 5 breaking, 4 info
- **2026-09-15** `8085d4c1ab80`: 3 breaking, 6 warning, 4 info
- **2026-09-10** `d26fed912541`: 5 breaking, 4 info
- **2026-09-08** `34a5be0cd6a2`: 3 breaking, 6 warning, 4 info
- **2026-08-21** `41e5cd97d4d7`: 5 breaking, 4 info
- **2026-08-21** `4c08f91a54b5`: 3 breaking, 6 warning, 4 info

## Changes

- **2026-09-29** `f9510f3f4b22`: 5 breaking, 4 info
  - added the new required request property `caoNumber`
  - added the new required request property `registration`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `companyId`
  - added the new optional request property `functionSubType`
  - added the new optional request property `functionType`
  - added the optional property `surcharges` to the response with the `200` status
- **2026-09-29** `3352b56bb8fe`: 3 breaking, 6 warning, 4 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the request property `caoNumber`
  - removed the request property `companyId`
  - removed the request property `functionSubType`
  - removed the request property `functionType`
  - removed the request property `registration`
  - removed the optional property `surcharges` from the response with the `200` status
  - response schema `application/json` enum value removed `COMPANY_DOES_NOT_EXIST`
  - response schema `application/json` enum value removed `INVALID_COLLECTIVE_LABOUR_AGREEMENT_NUMBER`
  - response schema `application/json` enum value removed `REGISTRATION_EXCEEDS_MAXIMUM_HOURS`
  - response schema `application/json` enum value removed `START_DATE_TIME_MUST_BE_BEFORE_END_DATE_TIME`
- **2026-09-16** `ccf9834e5006`: 5 breaking, 4 info
  - added the new required request property `caoNumber`
  - added the new required request property `registration`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `companyId`
  - added the new optional request property `functionSubType`
  - added the new optional request property `functionType`
  - added the optional property `surcharges` to the response with the `200` status
- **2026-09-15** `8085d4c1ab80`: 3 breaking, 6 warning, 4 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the request property `caoNumber`
  - removed the request property `companyId`
  - removed the request property `functionSubType`
  - removed the request property `functionType`
  - removed the request property `registration`
  - removed the optional property `surcharges` from the response with the `200` status
  - response schema `application/json` enum value removed `COMPANY_DOES_NOT_EXIST`
  - response schema `application/json` enum value removed `INVALID_COLLECTIVE_LABOUR_AGREEMENT_NUMBER`
  - response schema `application/json` enum value removed `REGISTRATION_EXCEEDS_MAXIMUM_HOURS`
  - response schema `application/json` enum value removed `START_DATE_TIME_MUST_BE_BEFORE_END_DATE_TIME`
- **2026-09-10** `d26fed912541`: 5 breaking, 4 info
  - added the new required request property `caoNumber`
  - added the new required request property `registration`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `companyId`
  - added the new optional request property `functionSubType`
  - added the new optional request property `functionType`
  - added the optional property `surcharges` to the response with the `200` status
- **2026-09-08** `34a5be0cd6a2`: 3 breaking, 6 warning, 4 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the request property `caoNumber`
  - removed the request property `companyId`
  - removed the request property `functionSubType`
  - removed the request property `functionType`
  - removed the request property `registration`
  - removed the optional property `surcharges` from the response with the `200` status
  - response schema `application/json` enum value removed `COMPANY_DOES_NOT_EXIST`
  - response schema `application/json` enum value removed `INVALID_COLLECTIVE_LABOUR_AGREEMENT_NUMBER`
  - response schema `application/json` enum value removed `REGISTRATION_EXCEEDS_MAXIMUM_HOURS`
  - response schema `application/json` enum value removed `START_DATE_TIME_MUST_BE_BEFORE_END_DATE_TIME`
- **2026-08-21** `41e5cd97d4d7`: 5 breaking, 4 info
  - added the new required request property `caoNumber`
  - added the new required request property `registration`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `companyId`
  - added the new optional request property `functionSubType`
  - added the new optional request property `functionType`
  - added the optional property `surcharges` to the response with the `200` status
- **2026-08-21** `4c08f91a54b5`: 3 breaking, 6 warning, 4 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the request property `caoNumber`
  - removed the request property `companyId`
  - removed the request property `functionSubType`
  - removed the request property `functionType`
  - removed the request property `registration`
  - removed the optional property `surcharges` from the response with the `200` status
  - response schema `application/json` enum value removed `COMPANY_DOES_NOT_EXIST`
  - response schema `application/json` enum value removed `INVALID_COLLECTIVE_LABOUR_AGREEMENT_NUMBER`
  - response schema `application/json` enum value removed `REGISTRATION_EXCEEDS_MAXIMUM_HOURS`
  - response schema `application/json` enum value removed `START_DATE_TIME_MUST_BE_BEFORE_END_DATE_TIME`

---

[Operation](https://skmtc.dev/maqqie/apis/maqqie-public-api/docs/public/surcharges/v1/retrieve-surcharges/post.md) - [API](https://skmtc.dev/maqqie/apis/maqqie-public-api.md) - [Page](https://skmtc.dev/maqqie/apis/maqqie-public-api/changes/public/surcharges/v1/retrieve-surcharges/post)