---
title: "ML training run history"
method: GET
path: "/api/v1/training-runs"
tags: ["Internal"]
---

# ML training run history

`GET /api/v1/training-runs`

## Request

- Base URL: `https://www.homecastr.com`
- URL: `https://www.homecastr.com/api/v1/training-runs`
- Auth: API key in header `x-api-key`

Lists ML model training runs with jurisdiction, instance type, duration, and compute cost. Requires a non-demo API key.

## Query parameters

- `jurisdiction` string
- `year` integer
- `limit` integer

## Response `200`

Training runs list

- object
  - `count` integer
  - `limit` integer
  - `filters` object
  - `runs` object[]
  - `_links` object

## Other responses

- `401`: API key required

---

[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)