# Get JWKS

`GET /auth/jwks` · Identity & Access · Auth Settings

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

| Name | In | Required | Description |
|---|---|---|---|
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes | The key set (RFC 7517). |
| `data.keys` | array of object | yes | 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. |
| `data.keys.[]kty` | string | yes | The key type: `OKP` for EdDSA keys, `RSA` for RS256 keys, `EC` for ES256 keys. |
| `data.keys.[]kid` | string | yes | The key id. A token's header names the `kid` it was signed with; pick the key with that id. |
| `data.keys.[]alg` | string | yes | The signing algorithm: `EdDSA`, `RS256` or `ES256`. |
| `data.keys.[]use` | string | yes | The key's use. Always `sig`: signatures. |
| `data.keys.[]crv` | string | no | The curve, for `OKP` (`Ed25519`) and `EC` (`P-256`) keys. Absent for `RSA` keys. |
| `data.keys.[]x` | string | no | The public key's x coordinate (the whole key for `OKP`), base64url-encoded. Present for `OKP` and `EC` keys. |
| `data.keys.[]y` | string | no | The public key's y coordinate, base64url-encoded. Present for `EC` keys only. |
| `data.keys.[]n` | string | no | The RSA modulus, base64url-encoded. Present for `RSA` keys only. |
| `data.keys.[]e` | string | no | The RSA public exponent, base64url-encoded. Present for `RSA` keys only. |
| `meta` | object | yes | Request metadata: cost, timing and the request and trace ids. |


## Errors

| HTTP | Code | When |
|---|---|---|
| 410 | `K9O_SLUG_GONE` | The project slug in the URL has been renamed; update your integration to use the new slug. |

## Code samples

### cURL

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

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/auth/jwks', {
  method: 'GET',
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/identity-access/get-jwks
