Skip to main content
GET/auth/jwks

Get JWKS

Returns the public JSON Web Key Set used to verify bearer JWTs issued for this project.

Tokens can be verified locally against these keys without a round-trip to the gateway.

Keys rotate every 90 days; retiring keys stay in the set for 30 days post-rollover so tokens minted just before rotation continue to verify.

Parameters
projectSlug *path

The project's slug: the path segment after @.

It is unique within the org.

Responses
HTTPK9O CodeDescription
200Success
410K9O_SLUG_GONEThe project slug in the URL has been renamed; update your integration to use the new slug.
Response body (200)
data *object

The key set (RFC 7517).

keys *object[]

The public keys that verify access tokens signed for the project.

A key stays listed until it retires, so tokens signed just before a rollover still verify.

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

The list is never empty: with no active key the call returns 404.

kty *string

The key type: OKP for EdDSA keys, RSA for RS256 keys, EC for ES256 keys.

kid *string

The key id.

A token's header names the kid it was signed with; pick the key with that id.

alg *string

The signing algorithm: EdDSA, RS256 or ES256.

use *string

The key's use.

Always sig: signatures.

crvstring

The curve, for OKP (Ed25519) and EC (P-256) keys.

Absent for RSA keys.

xstring

The public key's x coordinate (the whole key for OKP), base64url-encoded.

Present for OKP and EC keys.

ystring

The public key's y coordinate, base64url-encoded.

Present for EC keys only.

nstring

The RSA modulus, base64url-encoded.

Present for RSA keys only.

estring

The RSA public exponent, base64url-encoded.

Present for RSA keys only.

meta *any

Request metadata: cost, timing and the request and trace ids.

cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/auth/jwks'

Showing example in cURL

Response example (200)
{
  "data": {
    "keys": [
      {
        "kty": "string",
        "kid": "string",
        "alg": "string",
        "use": "string",
        "crv": "string",
        "x": "string",
        "y": "string",
        "n": "string",
        "e": "string"
      }
    ]
  }
}