---
title: "List proofs"
method: GET
path: "/proofs"
tags: ["Proofs"]
---

# List proofs

`GET /proofs`

Retrieve a filtered and paginated list of proofs.

## Query parameters

- `block` union
  - integer
  - string
- `clusters` string
- `limit` integer
- `offset` integer

## Response `200`

List of proofs retrieved successfully

- object
  - `proofs` object[], required
    - `block_number` number, required
    - `cluster_id` number, required
    - `proof_id` integer, required
    - `proof_status` 'queued' | 'proving' | 'proved', required
    - `proving_cycles` integer
    - `team_id` string, uuid, required
    - `created_at` string, required
    - `proved_timestamp` string
    - `proving_timestamp` string
    - `queued_timestamp` string
    - `proving_time` integer
    - `program_id` integer
    - `size_bytes` integer
    - `team` object
      - `id` string, uuid, required
      - `name` string, required
      - `slug` string, required
      - `created_at` string, required
      - `updated_at` string
    - `block` object
      - `block_number` integer, required
      - `hash` string, required
      - `timestamp` string, required
      - `gas_used` integer, required
      - `transaction_count` integer, required
      - `created_at` string, required
      - `updated_at` string
    - `cluster_version` object
      - `id` integer, required
      - `cluster_id` string, uuid, required
      - `index` integer, required
      - `zkvm_version_id` integer, required
      - `vk_path` string, nullable, required
      - `is_active` boolean, required
      - `created_at` string, required
      - `cluster` object
        - `id` string, uuid, required
        - `name` string, required
        - `team_id` string, uuid, required
        - `hardware_description` string, nullable, required
        - `is_open_source` boolean, required
        - `num_gpus` integer, required
        - `is_active` boolean, required
        - `software_link` string, nullable, required
        - `created_at` string, required
      - `zkvm_version` object
        - `id` integer, required
        - `version` string, required
        - `zkvm_id` integer, required
        - `created_at` string, required
        - `zkvm` object
          - `id` integer, required
          - `name` string, required
          - `slug` string, required
          - `isa` string, required
          - `team_id` string, uuid, required
          - `created_at` string, required
  - `total_count` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `400` — Invalid query parameters
- `401` — Invalid API key
- `422` — Validation error
- `500` — Internal server error

## Changes

- **2026-01-09** `9774b7b42209` — 2 breaking
  - removed the required property `proofs/items/cluster_version/cluster/is_multi_gpu` from the response with the `200` status
  - removed the required property `proofs/items/cluster_version/zkvm_version/release_date` from the response with the `200` status
- **2025-12-29** `0b475fbd2ae7` — 1 breaking, 4 warning, 11 info
  - removed the required property `proofs/items/cluster_version/version` from the response with the `200` status
  - removed the optional property `proofs/items/cluster_version/cluster/nickname` from the response with the `200` status
  - removed the optional property `proofs/items/cluster_version/cluster/updated_at` from the response with the `200` status
  - removed the optional property `proofs/items/cluster_version/cluster_machines` from the response with the `200` status
  - …12 more
- **2025-12-16** `dad824267266` — 2 info
  - the endpoint scheme security `apikey` was added to the API
  - added the non-success response with the status `401`
- **2025-10-29** `6d1c646eee4a` — 1 warning, 1 info
  - deleted the `query` request parameter `cluster_ids`
  - added the new optional `query` request parameter `clusters`
- **2025-10-29** `d4565858d6e0` — 1 warning, 1 info
  - deleted the `query` request parameter `team`
  - added the new optional `query` request parameter `cluster_ids`

[Full history](https://skmtc.dev/ethproofs/apis/ethproofs-api/changes/proofs/get.md)

---

[API](https://skmtc.dev/ethproofs/apis/ethproofs-api.md) · [All operations](https://skmtc.dev/ethproofs/apis/ethproofs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ethproofs/ethproofs-api/revisions/cad0595821db/schema)