Introduction

The Caoloon.com API provides renumeration data required by the lender (uitlener) from their customers. Through the API the user can conduct the process of requesting and obtaining the data from the customers. The Caoloon.com API provides both relevant Collective Labour Agreement (CLA) data and specific renumeration data of the customer from the Inquiry Pay Equity (IPE)

Versioning

This API follows the Semantic Versioning model consisting of consisting a MAJOR, MINOR, and PATCH version:

  • MAJOR version for incompatible API changes
  • MINOR version for added functionality in a backward compatible manner
  • PATCH version for backward compatible bug fixes

All future version changes will be documented in this file.

Versions can be specified through the Accept header. Here's an example HTTP request using the accept header versioning style:

GET /portal/ipe/ HTTP/1.1
Host: caoloon.com
Accept: application/json; version=2.5.1

Changelog

5.0.0 - 2025-12-17

  • Add /html element to IPE and CLA
  • Zfill coc numbers
  • Give list of applying company coc numbers in /IPE list endpoint
  • Modify coc filter to work with list of coc numbers

4.0.0 - 2025-11-20

  • Add a sbi filter to /IPE and /CLA endpoints
  • Make /IPE and /CLA have the same workType->sickLeave structure for the diff

3.1.1 - 2025-11-18

  • Fix a bug related to the "sentBy" paramter in the /invitation endpoint

3.1.0 - 2025-11-12

  • Add "waitingDays" and "sameSickLeaveInDays" to /IPE endpoint

3.0.0 - 2025-11-12

  • Rename salaryTable "periodiekVerhogingText" to "periodicalRaisesText" in line with English variable names.
  • Add a "customerGuid" to the /IPE list endpoint
  • Add a filter on "customerGuid"
  • Fix a bug in the "versionGuid" filter which caused unversioned IPE elements to be returned when filtering
  • Add a "sentBy" parameter to the /invitation endpoint

2.0.1 - 2025-11-03

  • Fix an error in number comparison of claDiff filter

2.0.0 - 2025-10-31

  • Move to a uuid structure for invitations

1.0.1 - 2025-10-30

  • Fixed a problem with the /IPE latest filter
  • Fixed a problem with the /IPE enabled filter
  • Fixed a problem with IPEs not based on a CLA

1.0.0 - 2025-10-10

Changed

  • Group all unstructured text fields in IPE/CLA response
  • Add a "versionDiff" filter to the IPE endpoint
  • Add offerHelp parameter toe invitation endpoint POST form

0.2.0 - 2025-10-06

Fixed

  • Fix outdated references to 'kvk' in the cla endpoint

0.1.0 - 2025-09-29

Changed

  • Add a claDiff filter to the IPE endpoint
  • Add a claCompare filter to the IPE endpoint