Skip to content
SupaCloud Docs
Select themeSelect language

`GET /api/marketplace/runner-usage` — list usage records for the current workspace (buyer side).

GET
/api/marketplace/runner-usage
curl --request GET \
  --url https://example.com/api/marketplace/runner-usage

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
status
string
limit
integer format: int64
offset
integer format: int64

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json
Array<object>

A single usage record for a marketplace runner offer. Created when a buyer workspace reserves a runner slot through a purchase, then transitions through running -> completed (or failed / timed_out / disputed). Financial fields capture the per-execution fee split at point-of-use so the ledger can be reconciled independently of later fee-policy changes.

object
actual_ms
integer | null format: int64
amount_minor
required
integer format: int32
buyer_workspace_id
required
string format: uuid
completed_at
string | null format: date-time
created_at
required
string format: date-time
currency
required
string
fee_policy_snapshot
required
id
required
string format: uuid
platform_fee_minor
required
integer format: int32
provider_net_minor
required
integer format: int32
purchase_id
required
string format: uuid
reserved_ms
required
integer format: int64
run_id
string | null format: uuid
runner_offer_id
required
string format: uuid
started_at
string | null format: date-time
status
required
string
updated_at
required
string format: date-time
Examplegenerated
[
  {
    "actual_ms": 1,
    "amount_minor": 1,
    "buyer_workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "completed_at": "2026-04-15T12:00:00Z",
    "created_at": "2026-04-15T12:00:00Z",
    "currency": "example",
    "fee_policy_snapshot": "example",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "platform_fee_minor": 1,
    "provider_net_minor": 1,
    "purchase_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "reserved_ms": 1,
    "run_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "runner_offer_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "started_at": "2026-04-15T12:00:00Z",
    "status": "example",
    "updated_at": "2026-04-15T12:00:00Z"
  }
]