---
title: "Changes to list runs"
method: GET
path: "/runs"
---

# Changes to list runs

`GET /runs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 20 revisions.

- **2026-11-13** `fac56b649559`: 1 warning
- **2026-10-30** `dcb4d45ade1a`: 8 info
- **2026-10-26** `246d92c52951`: 2 info
- **2026-10-13** `029668894d33`: 11 info
- **2026-09-25** `fb290371ab4c`: 3 breaking, 14 warning, 2 info
- **2026-09-14** `9dc1cf6b2c65`: 1 info
- **2026-09-09** `607d3222bfcd`: 3 info

## Changes

- **2026-11-13** `fac56b649559`: 1 warning
  - removed the optional property `runs/items/oneOf[#/components/schemas/Run]/legacy` from the response with the `200` status
- **2026-10-30** `dcb4d45ade1a`: 8 info
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `400` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `403` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `404` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `400` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `403` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `404` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/typical` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/upfront` to the response with the `200` status
- **2026-10-26** `246d92c52951`: 2 info
  - added the new optional `query` request parameter `dataset_id`
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/legacy` to the response with the `200` status
- **2026-10-13** `029668894d33`: 11 info
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `400` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `403` status
  - added the optional property `error/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `404` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/credit_detail/estimate/oneOf[#/components/schemas/CreditEstimate]/expected` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/progress/added_rows` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/progress/completed_rows` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/progress/generated_rows` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/progress/requested_rows` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/progress/running_rows` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/progress/skipped_duplicate_rows` to the response with the `200` status
  - added the optional property `runs/items/oneOf[#/components/schemas/Run]/progress/total_rows` to the response with the `200` status
- **2026-09-25** `fb290371ab4c`: 3 breaking, 14 warning, 2 info
  - the response property `pagination` became optional for the status `200`
  - added `#/components/schemas/RunListItem, #/components/schemas/Run` to the `runs/items/` response property `oneOf` list for the response status `200`
  - the `runs/items/` response's property type changed from `object` to no type for status `200`
  - removed the optional property `runs/items/app_url` from the response with the `200` status
  - removed the optional property `runs/items/created_at` from the response with the `200` status
  - removed the optional property `runs/items/credits_used` from the response with the `200` status
  - removed the optional property `runs/items/enrichment_id` from the response with the `200` status
  - removed the optional property `runs/items/enrichment_name` from the response with the `200` status
  - removed the optional property `runs/items/error` from the response with the `200` status
  - removed the optional property `runs/items/finished_at` from the response with the `200` status
  - removed the optional property `runs/items/id` from the response with the `200` status
  - removed the optional property `runs/items/result_url` from the response with the `200` status
  - removed the optional property `runs/items/row_count` from the response with the `200` status
  - removed the optional property `runs/items/started_at` from the response with the `200` status
  - removed the optional property `runs/items/status` from the response with the `200` status
  - removed the optional property `runs/items/stopped_reason` from the response with the `200` status
  - removed the optional property `runs/items/type` from the response with the `200` status
  - added the new optional `query` request parameter `ids`
  - added the optional property `not_found` to the response with the `200` status
- **2026-09-14** `9dc1cf6b2c65`: 1 info
  - added the optional property `runs/items/stopped_reason` to the response with the `200` status
- **2026-09-09** `607d3222bfcd`: 3 info
  - added the optional property `error/credit_detail` to the response with the `400` status
  - added the optional property `error/credit_detail` to the response with the `403` status
  - added the optional property `error/credit_detail` to the response with the `404` status

---

[Operation](https://skmtc.dev/riveterhq/apis/riveter-api/docs/runs/get.md) - [API](https://skmtc.dev/riveterhq/apis/riveter-api.md) - [Page](https://skmtc.dev/riveterhq/apis/riveter-api/changes/runs/get)
