List this agent's commerce requests

GET

/v1/commerce/requests

• Production
• Local

Authorizations

• AgentKey
  commerce:request

Parameters

Query Parameters

limit

integer

default: 50 >= 1 <= 100

Page size for the cursor-paginated agent surface (default 50; clamped to the 1-100 range).

page

string

Opaque page token echoed back from a prior next_page. Used by the legacy offset-paginated admin/console list surface; the cursor-paginated agent surface uses Cursor (?cursor) instead.

Responses

200

Ok

object

items

required

Array<object>

object

object

required

string

Allowed values: commerce_request

id

required

string

project_id

string

agent_id

Present when an agent initiated the request.

string

kind

required

string

Allowed values: domain_purchase plan_change

state

required

string

domain

string

domain_scope

string

Allowed values: org project

target_plan

string

current_plan

string

rationale

string

currency

required

string

quote_cents

required

integer format: int64

renewal_cents

required

integer format: int64

approved_max_cents

integer format: int64

quote_expires_at

string format: date-time

auto_renew

required

boolean

required_plan

string

required_plan_price_cents

integer format: int64

blocker_code

string

blockers

required

Array<object>

object

code

required

string

message

required

string

scope

string

limit_id

string

used_cents

integer format: int64

reserved_cents

integer format: int64

limit_cents

integer format: int64

requested_cents

integer format: int64

used_count

integer format: int64

reserved_count

integer format: int64

limit_count

integer format: int64

reset_at

string format: date-time

manage_url

string format: uri

approval_url

string format: uri

payment_action_url

string format: uri

external_job_id

string

effective_at

string format: date-time

agent_next_action

required

string

retry_safe

required

boolean

poll_after_seconds

required

integer

version

required

integer format: int64

notification_state

string

notification_last_error

string

created_at

required

string format: date-time

updated_at

required

string format: date-time

total

required

integer

next_cursor

string

401

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

403

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope