# List Anchors

`GET /anchors` · Core · Audit & Security

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

| Name | In | Required | Description |
|---|---|---|---|
| `cursor` | query | no | 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. |
| `limit` | query | no | 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 | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of object | yes | The project's anchors, newest first. The list is empty when the project has no anchors yet. |
| `data.[]anchorId` | string | yes | The anchor's id (`anc_...`). |
| `data.[]projectId` | string | yes | The project whose audit chain the anchor commits (`proj_...`). |
| `data.[]sequenceNumberFrom` | integer | yes | The first audit sequence number the anchor covers, inclusive. |
| `data.[]sequenceNumberAtAnchor` | integer | yes | The last audit sequence number the anchor covers, inclusive. It is the sequence of the chain head the anchor commits. |
| `data.[]ledgerHashAtSequence` | string | yes | 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. |
| `data.[]scheme` | string | yes | 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. |
| `data.[]previousAnchorHead` | object | yes | The chain head the previous anchor committed, which links the anchors to each other. Null on the project's first anchor. |
| _one of_ | | |  |
| _or_ | | |  |
| `data.[]anchorSignature` | string | yes | 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`. |
| `data.[]signingKeyKid` | string | yes | The `kid` of the platform key that signed the anchor. |
| `data.[]capturedAt` | string (date-time) | yes | When the anchor was captured and signed. |
| `data.[]externalLogReceipt` | object | yes | The receipt from the external transparency log, or null when the anchor was not published there. |
| _one of_ | | |  |
| `data.[]externalLogReceipt.publishedAt` | string (date-time) | yes | When the anchor was published to the external transparency log. |
| `data.[]externalLogReceipt.transparencyLogEntryId` | string | yes | The entry id the external log gave the anchor. |
| _or_ | | |  |
| `meta` | object | yes |  |


## Errors

| HTTP | Code | When |
|---|---|---|
| 401 | `K9O_SESSION_EXPIRED` | Your session has expired; re-authenticate and retry. |
| 403 | `K9O_ACCESS_DENIED` | Your role does not include the PROJECT_ADMIN or PROJECT_AUDITOR permission required to list transparency anchors. |
| 403 | `K9O_TRUST_ZONE_VIOLATION` | End-user identities are not permitted to access vault endpoints; use an operator credential. |
| 403 | `K9O_VAULT_OP_SCOPE_MISSING` | The service token presented does not carry the vault.secrets.read scope required for this vault operation. |
| 403 | `K9O_TRUST_TIER_INSUFFICIENT` | The crypto plane's declared attestation tier does not satisfy the project's trust-tier policy; no silent fallback is made. |
| 502 | `K9O_CHAIN_HASH_TAMPERING_DETECTED` | A hash-chain integrity check during anchor verification detected tampering; the request cannot complete safely. |

## Code samples

### cURL

```bash
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/anchors' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

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


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/list-anchors
