/vault/keys/{key_id}Get Key
Returns one of the project's keys.
Needs PROJECT_ADMIN or PROJECT_AUDITOR.
| projectId * | query | The project's id. |
| key_id * | path | The key's id. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | The key. | |
| 401 | The request carries no authenticated caller. | |
| 404 | No such key in the project. | |
| 500 | An internal error. Retry later. |
| byokRef | any | |
| One of: null | ||
| or: object | ||
| externalKeyId * | string | Provider-specific external key identifier (e.g., AWS KMS key ARN; GCP Cloud KMS resource path). Example: "arn:aws:kms:eu-central-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" |
| provider * | string | BYOK provider slug — Example: "aws-kms" |
| region * | string | The project's region pin ( The key's own provider location is inside Example: "de01" |
| createdAt * | string <date-time> | Key creation timestamp. Example: "2026-11-01T08:00:00.000Z" |
| custodyMode * | "PLATFORM_MANAGED" | "CONFIDENTIAL_WORKLOAD" | "BYOK" | "HYOK" | Custody mode of a project's vault. |
| hyokRef | any | |
| One of: null | ||
| or: object | ||
| clusterId * | string | Identifier of the HYOK cluster this key is scoped to. Example: "hyokcluster_0b6f2c1e-3d4a-4b5c-8d9e-0f1a2b3c4d5e" |
| clusterName * | string | Human-readable cluster name. Example: "luna-prod-eu" |
| keyHandle * | string | HSM-specific opaque key handle. Example: "e3c5a2b1-7d4f-4a9e-b6c8-1f2e3d4c5b6a" |
| id * | string | Key identifier — UUID prefixed Example: "vkey_7Rt2Wq9LxP4m" |
| keyType * | string | Key type — currently Example: "AES-256-GCM-SIV" |
| projectId * | string | Project this key belongs to. Example: "3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b" |
| purpose * | string | Key purpose. v2 customer-facing inventory keys serve data encryption only; the platform's ledger-signing key is platform-internal and not in this inventory. Example: "data-encryption" |
| revokedAt | string <date-time> | null | Revocation timestamp; null unless Example: "2026-11-15T09:30:00.123Z" |
| rotatedAt | string <date-time> | null | Last successful rotation completion timestamp; null if never rotated. Example: "2026-11-15T09:30:00.123Z" |
| status * | "active" | "rotating" | "revoked" | Status of a vault key lifecycle ( |
| version * | integer <int64> | Monotone version scalar — starts at 1; incremented on each successful rotation. Example: 3 |
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.keys.get('<keyId>')Showing example in TypeScript
{
"createdAt": "2026-11-01T08:00:00.000Z",
"custodyMode": "PLATFORM_MANAGED",
"id": "vkey_7Rt2Wq9LxP4m",
"keyType": "AES-256-GCM-SIV",
"projectId": "3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b",
"purpose": "data-encryption",
"revokedAt": "2026-11-15T09:30:00.123Z",
"rotatedAt": "2026-11-15T09:30:00.123Z",
"status": "active",
"version": 3
}