---
title: "(Unstable) Get the proofs of a Cardano block list"
method: GET
path: "/proof/v2/cardano-block"
---

# (Unstable) Get the proofs of a Cardano block list

`GET /proof/v2/cardano-block`

Returns block hashes and associated transaction proofs from the latest
Cardano Blocks and Transactions signed entity.
Using this endpoint require Aggregator's capabilities to include `CardanoBlocksTransactions` in the `signed_entity_types`

## Query parameters

- `block_hashes` string[], required

## Response `200`

Cardano block proofs found

- CardanoBlockProofMessage — This message represents a proof of inclusion for Cardano Blocks.
  - `certificate_hash` string, bytes, required — Hash of the certificate that validate the merkle root of this proof
  - `certified_blocks` union, required
    - unknown
    - object — Proof for certified Cardano blocks
      - `items` CardanoBlock[], required
        - `block_hash` string, bytes, required — Cardano block hash
        - `block_number` integer, required — Cardano block number
        - `slot_number` integer, required — Cardano slot number
      - `proof` string, bytes, required — Proof for the Cardano blocks
  - `non_certified_blocks` string[], required
  - `latest_block_number` integer, required — Last block number
  - `security_parameter` integer, required — The number of blocks from the tip of the chain at certification time

## Other responses

- `404` — No Cardano Blocks and Transactions snapshot available
- `default` — Cardano block proofs retrieval error

## Changes

- **2026-04-01** `82428f3522f5` — 1 info
  - added the required property `security_parameter` to the response with the `200` status
- **2026-03-12** `305d207c21c9` — 2 breaking
  - added `subschema #1, subschema #2` to the `certified_blocks` response property `oneOf` list for the response status `200`
  - the `certified_blocks` response's property type changed from `array` to no type for status `200`
- **2026-03-11** `31634eebc0c8` — 2 breaking, 2 info
  - removed the required property `certified_transactions` from the response with the `200` status
  - removed the required property `non_certified_transactions` from the response with the `200` status
  - added the required property `certified_blocks` to the response with the `200` status
  - added the required property `non_certified_blocks` to the response with the `200` status
- **2026-02-22** `2231ca9cc90d` — 2 breaking, 2 info
  - removed the required property `certified_blocks` from the response with the `200` status
  - removed the required property `non_certified_blocks` from the response with the `200` status
  - added the required property `certified_transactions` to the response with the `200` status
  - added the required property `non_certified_transactions` to the response with the `200` status
- **2026-02-14** `582b755e2c9c` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/input-output-hk/apis/mithril-aggregator-server/changes/proof/v2/cardano-block/get.md)

---

[API](https://skmtc.dev/input-output-hk/apis/mithril-aggregator-server.md) · [All operations](https://skmtc.dev/input-output-hk/apis/mithril-aggregator-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/input-output-hk/mithril-aggregator-server/revisions/bbad910c52a3/schema)