---
title: "List KMS key assignments"
method: GET
path: "/{tenantId}/kms/assignments"
tags: ["Assignments"]
---

# List KMS key assignments

`GET /{tenantId}/kms/assignments`

Lists KMS key assignments. Results can be filtered by provider, key alias, party, service, purpose, or assignment status.

## Query parameters

- `providerId` string
- `keyAlias` string
- `partyId` string
- `serviceType` string
- `serviceInstance` string
- `purpose` string
- `status` 'ACTIVE' | 'ROTATED' | 'REVOKED' | 'INACTIVE' — Lifecycle status for a key assignment.

## Response `200`

Matching key assignments.

- ListKmsKeyAssignmentsResult
  - `assignments` KmsKeyAssignment[], required
    - `assignmentId` string, required
    - `tenantId` string, required
    - `providerId` string, required
    - `keyAlias` string, required
    - `classification` 'PLATFORM' | 'TENANT' | 'APPLICATION' | 'SERVICE', required — Operational ownership scope for tenant-managed infrastructure resources.
    - `serviceType` string, nullable
    - `serviceInstance` string, nullable
    - `partyId` string, nullable
    - `relationshipType` string, nullable
    - `purpose` string, required
    - `validFrom` string, date-time, nullable
    - `validUntil` string, date-time, nullable
    - `status` 'ACTIVE' | 'ROTATED' | 'REVOKED' | 'INACTIVE', required — Lifecycle status for a key assignment.
    - `targetProviderId` string, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `400` — Bad request due to invalid input parameters or request body.
- `500` — An unexpected error occurred on the server.

## Changes

- **2026-06-26** `f4b160fd91dc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sphereon-opensource/apis/kms-rest-server-api/changes/:tenantId/kms/assignments/get.md)

---

[API](https://skmtc.dev/sphereon-opensource/apis/kms-rest-server-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/kms-rest-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/kms-rest-server-api/revisions/e9136cbde1c1/schema)