GET
/vault/audit-ledgerDownload Ledger
Returns the project's ledger events in sequence order, optionally limited to the range from to to.
The X-K9O-Ledger-Signature header carries an RSA-SHA256 signature over the body, base64.
Verify it with Get Signing Keys, and recompute the hash chain: each event's previousHash is the hash of the event before it.
Needs PROJECT_ADMIN or PROJECT_AUDITOR.
Parameters
| projectId * | query | The project's id. |
| from | query | The first ledger sequence number to return, inclusive. Without it, the ledger starts at its first event. |
| to | query | The last ledger sequence number to return, inclusive. Without it, the ledger runs to its latest event. |
| format | query | The response format. |
Responses
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | The ledger events, signed. | |
| 401 | The request carries no authenticated caller. | |
| 415 | `format` isn't `json`. | |
| 500 | An internal error. Retry later. |
Response body (200)
cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/vault/audit-ledger' \
-H 'Authorization: Bearer $K9O_TOKEN'Showing example in cURL
Response example (200)
[
{
"actorId": "usr_7Hq2LmN9pR4s",
"canonicalPayloadBytes": "{\"keyId\":\"vkey_7Rt2Wq9LxP4m\",\"newVersion\":4,\"previousVersion\":3}",
"eventId": "5b0e8f3a-2c1d-4e7b-9a6f-0d1c2b3a4e5f",
"eventType": "CUSTODY_MODE_TRANSITION",
"hash": "60303ae22b998861bce3b28f33eec1be758a213c86c93c076dbe9f558c11c752",
"orgId": "org_8kP3wQ9zLm2X",
"payload": {
"keyId": "vkey_7Rt2Wq9LxP4m",
"previousVersion": 3,
"newVersion": 4
},
"previousHash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"projectId": "3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b",
"sequenceNumber": 1842,
"timestamp": "2026-11-15T09:30:00.123Z"
}
]