---
title: "List benchmark and public-data assets"
method: GET
path: "/api/v1/benchmarks/catalog"
tags: ["Benchmarks"]
---

# List benchmark and public-data assets

`GET /api/v1/benchmarks/catalog`

## Request

- Base URL: `https://www.homecastr.com`
- URL: `https://www.homecastr.com/api/v1/benchmarks/catalog`
- Auth: none required

Catalog of public-safe benchmark and public-data assets, including release phase, support level, benchmark role, and recommended surface.

## Query parameters

- `asset_id` string
- `asset_class` string
- `phase` string
- `public_readiness` string
- `format` 'json' | 'csv'

## Response `200`

Benchmark catalog

- object
  - `dataset_count` integer
  - `launch_ready_count` integer
  - `filters` object
  - `datasets` BenchmarkCatalogEntry[]
    - `asset_id` string, required
    - `asset_class` string, required
    - `current_surface` string
    - `support_level` string, required
    - `target_family` string
    - `source_family` string
    - `license_status` string, required
    - `sensitivity` 'low' | 'medium' | 'high', required
    - `public_readiness` 'launch' | 'draft' | 'hold', required
    - `recommended_surface` string
    - `phase` string, required
    - `blockers` string
    - `next_step` string
    - `title` string
    - `description` string
    - `benchmark_role` string, required
    - `license_note` string, required
    - `data_snapshot_id` string, required
    - `model_version` string, nullable
    - `publication_date` string, date, nullable
    - `retrieval_date` string, date, nullable
    - `training_eligibility` 'benchmark_only' | 'consumer_feed' | 'training_candidate' | 'holdback', required
    - `formats` string[], required
    - `endpoint_family` 'catalog' | 'vintages' | 'backtests' | 'sources' | 'forecast' | 'download' | 'none', required
    - `example_path` string, nullable
    - `_links` object
  - `_links` object

## Other responses

- `404`: Unknown asset_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)