[1.15.1] - 2026-11-09
Fixed
PUT /organizations/{organizationId}/collaborators/{collaboratorId}/affiliationsnow returns404when the collaborator does not belong to the organization or to theestablishmentIdestablishment, or when the complementary contract does not belong to that organization, establishment and the calling partner, including for an exemption without option
[1.15.0] - 2026-10-08
Added
- new built-in leave type that the absences list endpoint may return in
type:absence_preavis_non_effectue
[1.14.0] - 2026-10-08
Added
- new
non_salaried_collaboratoremployment type that the collaborators endpoints may return innatureContrat
[1.13.0] - 2026-09-30
Added
- the collaborator
countryOfBirthfield may now return a French overseas department:gp(Guadeloupe),mq(Martinique),gf(French Guiana),re(Réunion) andyt(Mayotte)
[1.12.0] - 2026-09-25
Added
- new built-in leave types that the absences list endpoint may return in
type:conge_proche_aidant,mobilite_volontaire_securiseeandactivite_partielle
[1.11.0] - 2026-08-03
Changed
organismeCodeis 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 (needsorg:absence:type:read)
[1.9.0] - 2026-06-29
Added
- expose
phoneNumberon the collaborators list and detail endpoints (needsorg:employee:details:read) - expose
managerandteamon the collaborators list endpoint (needsorg: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
emailis now returned with the baseorg:employee:readscope on the collaborators endpoints (previously requiredorg:employee:details:read)GET /organizations/[organizationId]/collaborators/[collaboratorId]now only requiresorg:employee:read; personal data is still returned only withorg:employee:details:read, so the endpoint can be used to resolve a collaborator by id with the base scope- renamed the absences response field
employeeIdtocollaboratorId, for consistency with the other endpoints
Note on versioning: renamingemployeeIdtocollaboratorIdis 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](needsorg:contract:details:read scope)
Changed
GET /organizations/[organizationId]/collaboratorsnow requiresorg:employee:details:readto return detailed personal data andorg:contract:details:readto return the current contract. Existing credentials with onlyorg:employee:readhave 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/companiesaliases 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 requestedstartDate/endDaterange, with an optionalstatusfilter and optionalestablishmentIdfilter
[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 requestedstartDate/endDaterange, with an optionalstatusfilter
[1.3.0] - 2026-06-18
Added
- add
statusfield (past/active/future) on the collaborators endpoint - expose all endpoints under the
/organizations/[organizationId]path, as an alias of/companies/[organizationId]
Changed
- make the
establishmentIdquery parameter optional on read endpoints (organization-wide results when omitted) - make
establishmentIdnullable in the OIDC user info response
[1.2.1] - 2026-02-03
Fixed
- do not allow non positive numbers for pagination
pageandlimitparameters
[1.2.0] - 2026-01-07
Changed
- make
estCadreboolean 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

