> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Providers

> API changes for the Providers module.

<Update label="2026-09-11">
  **2 API change(s)**

  **`GET /rs/providers/v1/`**

  * added the required property `data/items/contacts/items/actions` to the response with the `200` status

  **`GET /rs/providers/v1/{id}`**

  * added the required property `contacts/items/actions` to the response with the `200` status
</Update>

<Update label="2026-09-07">
  **18 API change(s) - ⚠️ includes 18 breaking change(s)**

  **`GET /rs/providers/v1/`**

  * for the `query` request parameter `whereITIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
  * for the `query` request parameter `whereLabelIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
  * for the `query` request parameter `whereUnitIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`

  **`POST /rs/providers/v1/batch-archive`**

  * added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `anyOf[subschema #2]/where/whereITIds/items/`
  * added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `anyOf[subschema #2]/where/whereLabelIds/items/`
  * added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `anyOf[subschema #2]/where/whereUnitIds/items/`
  * the `anyOf[subschema #2]/where/whereITIds/items/` request property type/format changed from `string`/\`\` to `string`/`uuid`
  * the `anyOf[subschema #2]/where/whereLabelIds/items/` request property type/format changed from `string`/\`\` to `string`/`uuid`
  * the `anyOf[subschema #2]/where/whereUnitIds/items/` request property type/format changed from `string`/\`\` to `string`/`uuid`

  **`POST /rs/providers/v1/batch-unarchive`**

  * added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `anyOf[subschema #2]/where/whereITIds/items/`
  * added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `anyOf[subschema #2]/where/whereLabelIds/items/`
  * added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `anyOf[subschema #2]/where/whereUnitIds/items/`
  * the `anyOf[subschema #2]/where/whereITIds/items/` request property type/format changed from `string`/\`\` to `string`/`uuid`
  * the `anyOf[subschema #2]/where/whereLabelIds/items/` request property type/format changed from `string`/\`\` to `string`/`uuid`
  * the `anyOf[subschema #2]/where/whereUnitIds/items/` request property type/format changed from `string`/\`\` to `string`/`uuid`

  **`GET /rs/providers/v1/summary`**

  * for the `query` request parameter `whereITIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
  * for the `query` request parameter `whereLabelIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
  * for the `query` request parameter `whereUnitIds`, the type/format of property `items/` was specialized from `string`/\`\` to `string`/`uuid`
</Update>

<Update label="2026-09-03">
  **9 API change(s) - ⚠️ includes 4 breaking change(s)**

  **`POST /rs/providers/v1/batch-archive`**

  * the request's body type/format changed from `object`/`to`/\`\`
  * removed the request property `ids`
  * added `subschema #1, subschema #2` to the request body `anyOf` list

  **`POST /rs/providers/v1/batch-unarchive`**

  * the request's body type/format changed from `object`/`to`/\`\`
  * removed the request property `ids`
  * added `subschema #1, subschema #2` to the request body `anyOf` list

  **`GET /rs/providers/v1/`**

  * added the required property `data/items/nameInitial` to the response with the `200` status

  **`GET /rs/providers/v1/{id}/pin`**

  * added the required property `activeAccessCount` to the response with the `200` status
  * added the required property `pinRotatedAt` to the response with the `200` status
</Update>

<Update label="2026-09-01 (#727)">
  **2 API change(s)**

  **`GET /rs/providers/v1/`**

  * added the enum value `createdAt` to the property `items/field` of the `query` request parameter `orderBy`
  * added the enum value `updatedAt` to the property `items/field` of the `query` request parameter `orderBy`
</Update>

<Update label="2026-09-01">
  **4 API change(s)**

  **`GET /rs/providers/v1/`**

  * added the new optional `query` request parameter `whereNameInitial`
  * added the enum value `contract-status` to the property `items/` of the `query` request parameter `extend`
  * added the optional property `data/items/contractStatus` to the response with the `200` status

  **`GET /rs/providers/v1/summary`**

  * endpoint added
</Update>

<Update label="2026-08-28">
  **4 API change(s) - ⚠️ includes 2 breaking change(s)**

  **`POST /rs/providers/v1/{id}/archive`**

  * api path removed without deprecation

  **`POST /rs/providers/v1/{id}/unarchive`**

  * api path removed without deprecation

  **`POST /rs/providers/v1/batch-archive`**

  * endpoint added

  **`POST /rs/providers/v1/batch-unarchive`**

  * endpoint added
</Update>

<Update label="2026-08-27 (#683)">
  **1 API change(s)**

  **`GET /rs/providers/v1/{id}/pin`**

  * the `pinCode` response's property pattern `^[A-Z0-9]{3,8}-\d{6}$` was removed for the status `200`
</Update>

<Update label="2026-08-27">
  **4 API change(s)**

  **`GET /rs/providers/v1/`**

  * added the required property `data/items/country` to the response with the `200` status

  **`POST /rs/providers/v1/`**

  * added the new optional request property `country`

  **`GET /rs/providers/v1/{id}`**

  * added the required property `country` to the response with the `200` status

  **`PATCH /rs/providers/v1/{id}`**

  * added the new optional request property `country`
</Update>

<Update label="2026-08-26">
  **1 API change(s)**

  **`GET /rs/providers/v1/`**

  * added the new optional `query` request parameter `countOnly`
</Update>

<Update label="2026-08-05">
  **10 API change(s) — ⚠️ includes 4 breaking change(s)**

  **`POST /rs/providers/v1/`**

  * removed the enum value `training_company` of the request property `types/items/`
  * added the new `training_provider` enum value to the request property `types/items/`

  **`PATCH /rs/providers/v1/{id}`**

  * removed the enum value `training_company` of the request property `types/items/`
  * added the new `training_provider` enum value to the request property `types/items/`

  **`GET /rs/providers/v1/`**

  * added the new `training_provider` enum value to the `data/items/types/items/` response property for the response status `200`
  * removed the `training_company` enum value from the `data/items/types/items/` response property for the response status `200`

  **`GET /rs/providers/v1/{id}`**

  * added the new `training_provider` enum value to the `types/items/` response property for the response status `200`
  * removed the `training_company` enum value from the `types/items/` response property for the response status `200`

  **`GET /rs/providers/v1/{id}/pin`**

  * endpoint added

  **`POST /rs/providers/v1/{id}/rotate-pin`**

  * endpoint added
</Update>

<Update label="2026-07-27">
  **9 API change(s)**

  **`GET /rs/providers/v1/`**

  * added the new optional `query` request parameter `whereArchived`
  * added the enum value `actions-info` to the property `items/` of the `query` request parameter `extend`
  * added the optional property `data/items/actions` to the response with the `200` status
  * added the required property `data/items/archivedAt` to the response with the `200` status

  **`GET /rs/providers/v1/{id}`**

  * added the enum value `actions-info` to the property `items/` of the `query` request parameter `extend`
  * added the optional property `actions` to the response with the `200` status
  * added the required property `archivedAt` to the response with the `200` status

  **`POST /rs/providers/v1/{id}/archive`**

  * endpoint added

  **`POST /rs/providers/v1/{id}/unarchive`**

  * endpoint added
</Update>

<Update label="2026-07-20">
  **1 API change(s)**

  **`GET /rs/providers/v1/{id}`**

  * added the new optional `query` request parameter `extend`
</Update>

<Update label="2026-07-17">
  **4 API change(s) — ⚠️ includes 2 breaking change(s)**

  **`GET /rs/providers/v1/`**

  * deleted the `query` request parameter `whereSiteIds`
  * deleted the `query` request parameter `whereTechnicalInstallationIds`
  * added the new optional `query` request parameter `whereITIds`
  * added the new optional `query` request parameter `whereUnitIds`
</Update>

<Update label="2026-07-15">
  **4 API change(s)**

  **`GET /rs/providers/v1/`**

  * endpoint added

  **`POST /rs/providers/v1/`**

  * endpoint added

  **`GET /rs/providers/v1/{id}`**

  * endpoint added

  **`PATCH /rs/providers/v1/{id}`**

  * endpoint added
</Update>