Skip to main content
GET/vault/audit-ledger

Download 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.

fromquery

The first ledger sequence number to return, inclusive.

Without it, the ledger starts at its first event.

toquery

The last ledger sequence number to return, inclusive.

Without it, the ledger runs to its latest event.

formatquery

The response format. json is the only one; any other value returns 415.

Responses
HTTPK9O CodeDescription
200The ledger events, signed.
401The request carries no authenticated caller.
415`format` isn't `json`.
500An 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"
  }
]

More in Audit Ledger