Skip to main content
GET
List runs linked to a budget control

Authorizations

Authorization
string
header
required

Monid API key (Authorization: Bearer mk_...) or Clerk-issued JWT. Each operation lists the ONE scope an API key needs. {resource}:* grants every action on that resource; * grants everything; Clerk sessions hold *. Operations with an empty list need no scope. Scope catalog: GET /v1/api-keys/scopes.

Headers

X-Monid-Agent-Model
string

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256
X-Monid-Agent-Harness
string

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256
X-Monid-Agent-Session-Id
string

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256

Path Parameters

budgetControlId
string
required

Budget control ID (ULID).

Example:

"01JC2Z0A9V8Q4R6T8Y0B2D4F6H"

Query Parameters

windowStart
string

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

Example:

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

status
enum<string>

Filter runs by junction status.

Available options:
HELD,
SETTLED,
RELEASED
limit
integer

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

Required range: x <= 100
Example:

25

cursor
string

Cursor returned by the previous page.

Response

Budget control runs page

items
object[]
required
cursor
string | null
required

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