---
title: "Get canonical benchmark result"
method: GET
path: "/api/v1/data/benchmarks/{benchmark_id}"
tags: ["Data"]
---

# Get canonical benchmark result

`GET /api/v1/data/benchmarks/{benchmark_id}`

## Request

- Base URL: `https://www.homecastr.com`
- URL: `https://www.homecastr.com/api/v1/data/benchmarks/{benchmark_id}`
- Auth: none required

Returns one canonical benchmark result with standardized score rows, reproducibility references, and benchmark-only labeling.

## Path parameters

- `benchmark_id` string, required

## Query parameters

- `target` string

## Response `200`

Canonical benchmark result

- object
  - `schema_id` string
  - `schema_version` string
  - `benchmark_id` string
  - `data_snapshot_id` string
  - `filters` object
  - `score_count` integer
  - `record` CanonicalBenchmarkResultRecord
    - `schema_id` string, required
    - `schema_version` string, required
    - `record_id` string, required
    - `asset_id` string, required
    - `data_snapshot_id` string, required
    - `created_at` string, date-time, required
    - `provenance_id` string, nullable
    - `access_policy_id` string, nullable
    - `record_type` 'benchmark_result', required
    - `benchmark_id` string, required
    - `dataset_snapshot_ids` string[], required
    - `evaluation_cutoff` string, date-time, required
    - `split_definition` string, required
    - `model_versions` string[], required
    - `scores` CanonicalBenchmarkScore[], required
      - `metric_name` string, required
      - `value` number, nullable, required
      - `aggregation_level` string, required
      - `target` string, nullable, required
      - `horizon` integer, nullable, required
      - `baseline_name` string, nullable, required
      - `improvement` number, nullable, required
      - `sample_count` integer, nullable, required
      - `confidence_interval` number[], nullable, required
    - `reproducibility` object, required
      - `code_version` string, required
      - `config_id` string, required
      - `environment_id` string, nullable, required
      - `artifact_ids` string[], required
  - `provenance` DataProvenanceSummary
    - `provenance_id` string, required
    - `data_snapshot_id` string, required
    - `publication_date` string, date, nullable
    - `retrieval_date` string, date, nullable
    - `model_version` string, nullable
    - `license_note` string, required
  - `access` DataAccessSummary
    - `visibility` 'public' | 'metadata_only' | 'restricted' | 'unavailable', required
    - `support_level` string, required
    - `sensitivity` string, required
    - `training_eligibility` 'benchmark_only' | 'consumer_feed' | 'training_candidate' | 'holdback', required
    - `license_status` string, required
  - `_links` object

## Other responses

- `400`: Invalid benchmark query
- `404`: Unknown or empty benchmark_id

---

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