Changelog

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

​

[1.11.0] - 2026-08-03

​

Changed

• organismeCode is now nullable on the complementary contracts and affiliations read endpoints.

​

[1.10.0] - 2026-07-20

​

Added

• expose type (the leave code) on the absences list endpoint (needs org:absence:type:read)

​

[1.9.0] - 2026-06-29

​

Added

• expose phoneNumber on the collaborators list and detail endpoints (needs org:employee:details:read)
• expose manager and team on the collaborators list endpoint (needs org:employee:details:read)
• all paginated endpoints now return a deterministic order: collaborators by last name then first name, absences and work locations by start date; the collaborator contracts array (returned with org:contract:details:read, not paginated) is also sorted by start date

​

Changed

• email is now returned with the base org:employee:read scope on the collaborators endpoints (previously required org:employee:details:read)
• GET /organizations/[organizationId]/collaborators/[collaboratorId] now only requires org:employee:read; personal data is still returned only with org:employee:details:read, so the endpoint can be used to resolve a collaborator by id with the base scope
• renamed the absences response field employeeId to collaboratorId, for consistency with the other endpoints

Note on versioning: renaming employeeId to collaboratorId is technically a breaking change but is released as a minor version. The absences endpoint has no production consumer yet, so the rename breaks no one in practice.

​

[1.8.0] - 2026-06-29

​

Added

• List of contracts in API GET /organizations/[organizationId]/collaborators/[collaboratorId] (needs org:contract:details:read scope)

​

Changed

• GET /organizations/[organizationId]/collaborators now requires org:employee:details:read to return detailed personal data and org:contract:details:read to return the current contract. Existing credentials with only org:employee:read have been migrated to include both scopes.

​

[1.7.0] - 2026-06-26

​

Removed

• Breaking change: removed all /companies/[organizationId] endpoints (company, collaborators, complementary-contracts, meal-vouchers). Use the /organizations/[organizationId] equivalents instead (available since v1.3.0).

Note on versioning: although this is technically a breaking change, it is released as a minor version (not a major bump). Every known consumer has already migrated to the /organizations/[organizationId] endpoints, so removing the /companies aliases breaks no one in practice. This is a deliberate, one-off exception to our Semantic Versioning policy; it is not a precedent (future breaking changes will still warrant a major version bump).

​

[1.6.0] - 2026-06-23

​

Added

• work locations API: GET /organizations/[organizationId]/work-locations, returning work locations overlapping the requested startDate/endDate range, with an optional status filter and optional establishmentId filter

​

[1.5.0] - 2026-06-22

​

Added

• collaborator API: GET /organizations/[organizationId]/collaborators/[collaboratorId], returning a specific collaborator with detailed personal data.

​

[1.4.0] - 2026-06-22

​

Added

• absences API: GET /organizations/[organizationId]/absences, returning absences overlapping the requested startDate/endDate range, with an optional status filter

​

[1.3.0] - 2026-06-18

​

Added

• add status field (past / active / future) on the collaborators endpoint
• expose all endpoints under the /organizations/[organizationId] path, as an alias of /companies/[organizationId]

​

Changed

• make the establishmentId query parameter optional on read endpoints (organization-wide results when omitted)
• make establishmentId nullable in the OIDC user info response

​

[1.2.1] - 2026-02-03

​

Fixed

• do not allow non positive numbers for pagination page and limit parameters

​

[1.2.0] - 2026-01-07

​

Changed

• make estCadre boolean field nullable

​

[1.1.0] - 2025-12-15

​

Added

• add “external_staff” employment type

​

[1.0.0] - 2025-10-15 (initial release)

​

Added

• company API
• collaborators API
• meal-vouchers API
• complementary-contracts API