Skip to main content
GET/anchors

List Anchors

Returns the cursor-paginated list of external transparency anchors for the project, ordered by capturedAt descending.

Each anchor records a signed snapshot of the project's audit-ledger state at a point in time, enabling independent verification that the platform has not retroactively modified the ledger.

Requires PROJECT_ADMIN or PROJECT_AUDITOR role.

Non-metered.

Parameters
cursorquery

The anchorId of the last anchor on the previous page.

The page starts with the anchor just before it.

Omit it for the first page.

limitquery

The number of anchors to return, as a decimal string.

Default 50, and values above 200 are capped at 200.

A value of 0 gives the default.

projectSlug *path

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

It is unique within the org.

Responses
HTTPK9O CodeDescription
200Success
401K9O_SESSION_EXPIREDYour session has expired; re-authenticate and retry.
403K9O_ACCESS_DENIEDYour role does not include the PROJECT_ADMIN or PROJECT_AUDITOR permission required to list transparency anchors.
403K9O_TRUST_ZONE_VIOLATIONEnd-user identities are not permitted to access vault endpoints; use an operator credential.
403K9O_VAULT_OP_SCOPE_MISSINGThe service token presented does not carry the vault.secrets.read scope required for this vault operation.
403K9O_TRUST_TIER_INSUFFICIENTThe crypto plane's declared attestation tier does not satisfy the project's trust-tier policy; no silent fallback is made.
502K9O_CHAIN_HASH_TAMPERING_DETECTEDA hash-chain integrity check during anchor verification detected tampering; the request cannot complete safely.
Response body (200)
data *object[]

The project's anchors, newest first.

The list is empty when the project has no anchors yet.

anchorId *string

The anchor's id (anc_...).

projectId *string

The project whose audit chain the anchor commits (proj_...).

sequenceNumberFrom *integer

The first audit sequence number the anchor covers, inclusive.

sequenceNumberAtAnchor *integer

The last audit sequence number the anchor covers, inclusive.

It is the sequence of the chain head the anchor commits.

ledgerHashAtSequence *string

The chain head at sequenceNumberAtAnchor: the row hash of that audit row.

Compare it with the head you compute from your own copy of the chain.

scheme *string

How to read ledgerHashAtSequence. row_hash_head_v2 means it is the audit chain's row hash at sequenceNumberAtAnchor.

The scheme inside anchorSignature is the authoritative one: this field mirrors it for querying.

previousAnchorHead *any

The chain head the previous anchor committed, which links the anchors to each other.

Null on the project's first anchor.

One of: string
or: null
anchorSignature *string

A compact JWS over the anchor's id, project, sequence range, chain head, previous head, scheme and capture time.

Verify it with the key signingKeyKid in the keys at GET /.well-known/ledger-jwks.

signingKeyKid *string

The kid of the platform key that signed the anchor.

capturedAt *string <date-time>

When the anchor was captured and signed.

externalLogReceipt *any

The receipt from the external transparency log, or null when the anchor was not published there.

One of: object
publishedAt *string <date-time>

When the anchor was published to the external transparency log.

transparencyLogEntryId *string

The entry id the external log gave the anchor.

or: null
meta *any
cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/anchors' \
  -H 'Authorization: Bearer $K9O_TOKEN'

Showing example in cURL

Response example (200)
{
  "data": [
    {
      "anchorId": "string",
      "projectId": "string",
      "sequenceNumberFrom": 0,
      "sequenceNumberAtAnchor": 0,
      "ledgerHashAtSequence": "string",
      "scheme": "string",
      "previousAnchorHead": "string",
      "anchorSignature": "string",
      "signingKeyKid": "string",
      "capturedAt": "string",
      "externalLogReceipt": {
        "publishedAt": "string",
        "transparencyLogEntryId": "string"
      }
    }
  ]
}

More in Audit & Security