--- title: "List KMS Key Rotations" method: GET path: "/kms-key/{id}/list-key-rotations" tags: ["kms-key"] --- # List KMS Key Rotations `GET /kms-key/{id}/list-key-rotations` ## Request - Base URL: `https://api-ch-gva-2.exoscale.com/v2` - URL: `https://api-ch-gva-2.exoscale.com/v2/kms-key/{id}/list-key-rotations` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) List all the key material versions of a KMS Key. ## Path parameters - `id` string, uuid, required ## Response `200` The list of all historical rotations for the requested KMS key. - ListKmsKeyRotationsResponse - `rotations` ListKmsKeyRotationsResponseEntry[], required: A chronologically ordered collection tracking historical rotation lifecycle occurrences for this resource. - `version` integer, required: The absolute increment index referencing this specific historical structural material setup. - `rotated-at` string, date-time, required: The UTC timestamp tracking precisely when this historical adjustment pass finished processing. - `automatic` boolean, required: Flag stating whether an automation run handled this historic mutation or if manual actor keys initiated it. ## Other responses - `400`: ### Errors Key Not Found: The request was rejected because the specified KMS Key could not be found. ## Changes - **2026-11-06** `63da6f74c845`: 2 warning - removed the optional property `errors` from the response with the `400` status - removed the optional property `instance` from the response with the `400` status - **2026-03-16** `e05707a7b346`: 1 info - endpoint added [Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/kms-key/:id/list-key-rotations/get.md) --- [API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)