---
title: "Get a benchmark run"
method: GET
path: "/v1/quality/benchmarks/{id}"
tags: ["Benchmarks"]
---

# Get a benchmark run

`GET /v1/quality/benchmarks/{id}`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/quality/benchmarks/{id}`
- Auth: HTTP bearer

Returns the benchmark run together with its per-document results.

## Path parameters

- `id` string, uuid, required

## Response `200`

Benchmark run with per-document results.

- BenchmarkDetailResponse
  - `id` string, uuid, required
  - `name` string, nullable
  - `dataset_id` string, uuid, nullable
  - `user_schema_id` string, uuid, nullable
  - `status` string, required: Benchmark run status.
  - `accuracy_overall` number, float, nullable
  - `accuracy_by_field` object, nullable
  - `documents_processed` integer, nullable
  - `documents_total` integer, nullable
  - `duration_ms` integer, nullable
  - `accuracy_delta` number, float, nullable: Change in overall accuracy vs the compared run.
  - `compared_to_run_id` string, uuid, nullable
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `links` object
    - `self` string
    - `results` string
  - `results` BenchmarkResultItem[]
    - `id` string, uuid
    - `document_id` string, uuid, nullable
    - `ground_truth_entry_id` string, uuid, nullable
    - `accuracy` number, float, nullable
    - `field_results` object: Per-field pass/fail results for this document.
    - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

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