Sign in

v1

latestOpenAPI 3.1.02026-08-044257268.7 KB
Controls

List runs linked to a budget control

Cursor-paginated list of run junctions for a budget control. Defaults to the current time window when windowStart is omitted.

get/v1/controls/workspace/budgets/{budgetControlId}/runs

Path parameters

budgetControlIdstring required

Budget control ID (ULID).

Example:01JC2Z0A9V8Q4R6T8Y0B2D4F6H

Budget control ID (ULID).

Query parameters

windowStartstring

ISO 8601 timestamp selecting a specific window. Defaults to the current window when omitted.

Example:2026-07-01T00:00:00.000Z

ISO 8601 timestamp selecting a specific window. Defaults to the current window when omitted.

status'HELD' | 'SETTLED' | 'RELEASED'

Filter runs by junction status.

Filter runs by junction status.

limitinteger

Max items per page (server-side cap applies).

Example:25

Max items per page (server-side cap applies).

cursorstring

Cursor returned by the previous page.

Cursor returned by the previous page.

Response

Budget control runs page

cursorstring nullable required

Opaque cursor for the next page. Null on the last page.

Example response

{
  "items": [
    {
      "runId": "01JC2Z0A9V8Q4R6T8Y0B2D4F6H"
    }
  ]
}