# List Secret Versions

`GET /vault/secrets/{path}?op=versions` · Keys & Secrets · Secrets

Returns a secret's value, base64. Send a challenge from Request Reveal Challenge in the `X-K9O-Reveal-Challenge` header: each challenge works once, within 60 seconds. With `op=versions`, returns the secret's version history instead, with no value, and needs no challenge. The secret's owner and the callers it is shared with can reveal it.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectId` | query | yes | The project's id. Example: `"3f2c9a4e-8b1d-4c6f-9e2a-7d5b1c0a4e8f"`. |
| `path` | path | yes | The secret's path: `/`-delimited segments, such as `database/prod/password`. Example: `"database/prod/password"`. |

## Responses

- **200**: Without `op`: the value. With `op=versions`: the version history.

| Field | Type | Required | Description |
|---|---|---|---|
| _one of_ | | |  |
| `attestationTier` | object | yes | The hardware trust the kibo node declares for this operation. |
| `attestationTier.operator` | string | yes | Who runs the node: `platform` for a platform-run node, `client` for one the customer runs. The platform sets it, never the workload. Example: `"platform"`. |
| `attestationTier.urn` | string | yes | The trust tier, as `attestation:destination:region`, such as `sev-snp:azure:us-east`. Example: `"sev-snp:azure:westeurope"`. |
| `attestationTier.verified` | boolean | yes | Whether the node's own attestation `verified` against the vendor PKI on the URN's `attestation` segment. `false` for the standard-hardened fallback (declared honestly, not masqueraded as a CVM). Example: `true`. |
| `id` | string | yes | `sec_<base62>`. Example: `"sec_4fK9xQ2mZ7aB"`. |
| `name` | string | yes | Path-name at reveal time. Example: `"database/prod/password"`. |
| `revealedAt` | string (date-time) | yes | Reveal timestamp. Example: `"2026-11-15T09:30:00.123Z"`. |
| `value` | string | yes | Plaintext bytes, base64-encoded (TLS-only transport). Example: `"czNjcjN0LXBhc3N3MHJk"`. |
| `version` | integer (int64) | yes | Revealed version. Example: `3`. |
| _or_ | | |  |
| `activeVersion` | integer (int64) | yes | The active version. Example: `3`. |
| `id` | string | yes | `sec_<base62>`. Example: `"sec_4fK9xQ2mZ7"`. |
| `name` | string | yes | The secret's path. Example: `"database/prod/password"`. |
| `versions` | array of object | yes | The version history, newest first. |
| `versions.[]createdAt` | string (date-time) | yes | When this version was written. Example: `"2026-11-14T16:05:12.004Z"`. |
| `versions.[]version` | integer (int64) | yes | The version number. Example: `3`. |


## Errors

| HTTP | Description |
|---|---|
| 401 | `K9O_REVEAL_CHALLENGE_REQUIRED`: no reveal challenge, or one kibo doesn't recognise. `K9O_REVEAL_CHALLENGE_EXPIRED`: the challenge is more than 60 seconds old. |
| 404 | No such secret visible to the caller. |
| 409 | `K9O_REVEAL_CHALLENGE_CONSUMED`: the challenge was already used. Request a new one. |

## Code samples

### cURL

```bash
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/vault/secrets/<name>?op=versions' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/vault/secrets/<name>?op=versions', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/keys-secrets/list-secret-versions
