Skip to main content
GET/rampart/jwks

Get Rampart Signing Keys

Returns the JSON Web Key Set (RFC 7517) that verifies Rampart classificationReceipt signatures.

Find the key whose kid matches the receipt's protected header.

The set lists only the classification-receipt keys, and keeps a retired key listed for a grace period so a receipt signed just before a key rotation still verifies.

Cache by kid and refetch when a kid is missing; responses are cacheable for 5 minutes.

Public: no authentication is required.

Responses
HTTPK9O CodeDescription
200Success
Response body (200)
keys *object[]

The public keys that sign classification receipts, newest first.

A key stays listed through its grace period after it is retired, so a receipt signed just before a rollover still verifies.

Cache keys by kid and fetch again when a receipt names a kid you don't have.

kty *"OKP"

The key type.

Receipt keys are Ed25519, so this is OKP.

crv *"Ed25519"

The curve of the key.

x *string

The public key, base64url-encoded with no padding.

kid *string

The key id.

A receipt's protected header names the kid it was signed with.

alg *"EdDSA"

The signing algorithm.

use *"sig"

The key's use: signatures.

k9o_signer_role *"public"

Which platform signer holds the private half.

Receipt keys are always held by the public gateway.

issuer *string

The iss claim every classification receipt carries.

Check a receipt's iss against this value.

meta *any
TypeScript
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.rampart.jwks()

Showing example in TypeScript

Response example (200)
{
  "keys": [
    {
      "kty": "OKP",
      "crv": "Ed25519",
      "x": "string",
      "kid": "string",
      "alg": "EdDSA",
      "use": "sig",
      "k9o_signer_role": "public"
    }
  ],
  "issuer": "string"
}

More in AI Safety