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.

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.

Response

Budget control runs page

cursorstring nullable required

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

Example response

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

Changes

Changed in 3 of the 22 revisions of this API.705

Sep 25, 20265abada71ceae65See the full diff
- ●
  added the new IDENTITY_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_RATE_LIMITED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_RATE_LIMITED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_RATE_LIMITED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_RATE_LIMITED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_RATE_LIMITED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_STATE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_STATE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_STATE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_STATE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_LINK_STATE_INVALID enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNKNOWN enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNKNOWN enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNKNOWN enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNKNOWN enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_PROVIDER_UNKNOWN enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_USER_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_USER_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_USER_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_USER_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_USER_ALREADY_LINKED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_VERIFICATION_FAILED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_VERIFICATION_FAILED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_VERIFICATION_FAILED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_VERIFICATION_FAILED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IDENTITY_VERIFICATION_FAILED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_SCOPE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_IDENTITY_REDEEMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_IDENTITY_REDEEMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_IDENTITY_REDEEMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_IDENTITY_REDEEMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_IDENTITY_REDEEMED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_REDEEM_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_REDEEM_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_REDEEM_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_REDEEM_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PROMO_REDEEM_REQUIRES_SESSION enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_INSUFFICIENT_FUNDS enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_INSUFFICIENT_FUNDS enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_INSUFFICIENT_FUNDS enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_INSUFFICIENT_FUNDS enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new WALLET_INSUFFICIENT_FUNDS enum value to the response property for the response status
  response-property-enum-value-added
Sep 23, 2026fadab791136c5See the full diff
- ●
  added the new X402_UNBOUNDED_PRICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new X402_UNBOUNDED_PRICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new X402_UNBOUNDED_PRICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new X402_UNBOUNDED_PRICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new X402_UNBOUNDED_PRICE enum value to the response property for the response status
  response-property-enum-value-added
Sep 11, 20269874d9e34fcf5See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added

Full history