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

[1.15.1] - 2026-11-09

Fixed

  • PUT /organizations/{organizationId}/collaborators/{collaboratorId}/affiliations now returns 404 when the collaborator does not belong to the organization or to the establishmentId establishment, 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_collaborator employment type that the collaborators endpoints may return in natureContrat

[1.13.0] - 2026-09-30

Added

  • the collaborator countryOfBirth field may now return a French overseas department: gp (Guadeloupe), mq (Martinique), gf (French Guiana), re (Réunion) and yt (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_securisee and activite_partielle

[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