> ## Documentation Index
> Fetch the complete documentation index at: https://developers.malibou.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> All notable changes to the malibou public API.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## \[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