# Get Anchor

`GET /anchors/{anchorId}` · Core · Audit & Security

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

| Name | In | Required | Description |
|---|---|---|---|
| `anchorId` | path | yes |  Example: `"anc_demo00000001"`. |
| `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` | object | yes | One signed transparency anchor over a range of a project's audit chain. |
| `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 read a transparency anchor. |
| 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. |
| 404 | `K9O_NOT_FOUND` | The anchor ID you supplied does not exist in this project's transparency-anchor history. |
| 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/anc_demo00000001' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

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


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/get-anchor
