---
title: "Get latest confirmed benchmarks for a player"
method: GET
path: "/get-benchmarks"
tags: ["GET"]
---

# Get latest confirmed benchmarks for a player

`GET /get-benchmarks`

# Notes

* Query parameter `<block_id>` must be the latest block. Use `/get-block` endpoint

* Query parameter `<player_id>` must be lowercase and start with `0x`

* Returns all confirmed precommits, benchmarks, proofs, and frauds for the player where the benchmark was started within `120` blocks of the latest block.

* Fields `benchmark.solution_nonces`, `benchmark.discarded_solution_nonces`, `benchmark.non_solution_nonces`, `proof.merkle_proofs`, and `fraud.allegation` will always be `null`

    * To retrieve that data, use /get-benchmark-data endpoint

## Query parameters

- `block_id` string, required
- `player_id` string, required

## Response `200`

Success

- GetBenchmarksResponse
  - `precommits` Precommit[]
    - `benchmark_id` string
    - `details` PrecommitDetails
      - `block_started` integer
      - `num_bundles` integer
      - `num_nonces` integer
      - `rand_hash` string
      - `fee_paid` string
      - `fuel_budget` integer
      - `hyperparameters` object
      - `compute_type` 'aws_t3' | 'aws_t3a' | 'aws_t4g' | 'aws_c7i' | 'aws_c7a' | 'aws_c7g' | 'aws_m7i' | 'aws_m7a' | 'aws_m7g' | 'aws_g4dn' — Compute that can reproduce the results
    - `settings` BenchmarkSettings
      - `player_id` string
      - `block_id` string
      - `challenge_id` string
      - `algorithm_id` string
      - `track_id` string
    - `state` PrecommitState
      - `block_confirmed` integer
    - `hyperparameters` object, nullable
  - `benchmarks` Benchmark[]
    - `id` string
    - `details` BenchmarkDetails
      - `num_solutions` integer
      - `num_discarded_solutions` integer
      - `num_non_solutions` integer
      - `merkle_root` string
      - `sampled_nonces` integer[]
    - `state` BenchmarkState
      - `block_confirmed` integer
    - `solution_nonces` integer[], nullable
    - `discarded_solution_nonces` integer[], nullable
    - `non_solution_nonces` integer[], nullable
  - `proofs` Proof[]
    - `benchmark_id` string
    - `details` ProofDetails
      - `submission_delay` integer
    - `state` ProofState
      - `block_confirmed` integer
      - `block_active` integer
    - `merkle_proofs` MerkleProof[], nullable
      - `leaf` OutputData
        - `nonce` integer
        - `runtime_signature` array[]
          - integer[]
        - `fuel_consumed` integer
        - `solution` object
        - `cpu_arch` 'amd64' | 'arm64'
      - `branch` string
  - `frauds` Fraud[]
    - `benchmark_id` string
    - `state` FraudState
      - `block_confirmed` integer
    - `allegation` string, nullable

---

[API](https://skmtc.net/tig-foundation/apis/the-innovation-game-api.md) · [All operations](https://skmtc.net/tig-foundation/apis/the-innovation-game-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tig-foundation/the-innovation-game-api/versions/2af9c398c1d4/schema)