---
title: "What the log holds in one completeness chain, signed"
method: GET
path: "/api/v2/evidence/chain"
tags: ["Evidence"]
---

# What the log holds in one completeness chain, signed

`GET /api/v2/evidence/chain`

## Request

- Base URL: `https://api.riskrouter.eu`
- URL: `https://api.riskrouter.eu/api/v2/evidence/chain`
- Auth: none declared

The length of the chain and, for each position from..to (at most 1,000 a page), the leaf index, the time it was sealed and the record digest, as of the current signed head, signed over riskrouter-evidence-chain|v1|chain_tag|length|tree_size|root_hash|timestamp|from|to|links_digest. Public: the tag is derived from a secret the firm keeps. Names no distributor and holds no record.

## Query parameters

- `chain_tag` string, required
- `from` integer
- `to` integer

## Response `200`

The signed statement.

- object
  - `format` 'riskrouter-evidence-chain|v1'
  - `chain_tag` string
  - `length` integer
  - `from` integer
  - `to` integer
  - `links` object[]
    - `chain_seq` integer
    - `leaf_index` integer
    - `created_at` string
    - `record_digest` string
  - `links_digest` string
  - `head` EvidenceHead
    - `tree_size` integer, required
    - `root_hash` string, required
    - `timestamp` string, date-time, required
  - `chain_signature` object
  - `chain_signature_unavailable` string
  - `next` string

## Other responses

- `400`: Every error carries the same envelope with a stable code.
- `413`: Every error carries the same envelope with a stable code.
- `429`: Every error carries the same envelope with a stable code.
- `502`: Every error carries the same envelope with a stable code.
- `503`: Every error carries the same envelope with a stable code.

---

[API](https://skmtc.dev/riskrouter/apis/riskrouter-api.md) · [All operations](https://skmtc.dev/riskrouter/apis/riskrouter-api/llms.txt) · [OpenAPI document](https://skmtc.dev/riskrouter/apis/riskrouter-api/revisions/5fee45dc6d1f?raw)
