Skip to main content
GET/anchors/{anchorId}

Get Anchor

Retrieves a single transparency anchor by its identifier (anc_<base62>).

The anchor includes the cumulative ledger hash at the captured sequence number, the platform's RSA-SHA256 signature, and an optional external-log receipt for third-party attestation.

Returns K9O_TRANSPARENCY_ANCHOR_NOT_FOUND (404) if the anchor does not exist in the project's anchor history.

Requires PROJECT_ADMIN or PROJECT_AUDITOR role.

Parameters
anchorId *path
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 read a transparency anchor.
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.
404K9O_NOT_FOUNDThe anchor ID you supplied does not exist in this project's transparency-anchor history.
502K9O_CHAIN_HASH_TAMPERING_DETECTEDA hash-chain integrity check during anchor verification detected tampering; the request cannot complete safely.
Response body (200)
data *object

One signed transparency anchor over a range of a project's audit chain.

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/anc_demo00000001' \
  -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