Get Stable KID lineage history

get

https://localhost:443/api/v3/audit/tenants/{tenantId}/crypto/keys/{keyId}/history

Returns cryptographic operations performed under a specific Stable KID (keyId = identity-layer alias). By default the response aggregates the FULL material lineage — every rotation generation of the alias — most-recent-first, with each entry carrying its materialVersion (the ank_kv of the key material in force at operation time). Pass the optional materialVersion query parameter to narrow the history to a single rotation generation. Useful for key lifecycle tracking, rotation forensics, and compliance audits.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

tenantId

uuid

required

Tenant UUID

keyId

string

required

length between 1 and 255

Key identifier

Query Params

materialVersion

integer

≥ 1

Optional FR-35 filter. When present, narrows the lineage history to a single material version (rotation generation) of the Stable KID. When omitted, ALL material versions are aggregated.

page

integer

≥ 0

Defaults to 0

Page number (zero-based, min: 0)

size

integer

1 to 100

Defaults to 20

Page size, with DIFFERENT contracts at the two ends. ABOVE 100 the value is capped and returned with HTTP 200 - there is no @Max, so size=5000 silently yields 100 rows. BELOW 1 it is REJECTED: only the upper bound is applied here, so a page size under one reaches PageRequest.of and raises, and size=0 returns 400 application/problem+json (as does a negative page). The declared maximum is therefore an EFFECTIVE cap while the declared minimum is enforced.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Key history retrieved successfully

400Bad Request: Invalid pagination parameters

404Not Found: Key not found

500Internal Server Error