Skip to content

Get Auto Top-up Settings

GET/v1/billing/auto-top-up

Authorization

Authorizationstring · headerRequired

Workspace session token sent as Bearer <token>. Authentication guide

Parameters

workspace_idquery · stringRequired

Responses

200Current automatic top-up policy and payment method summary.
application/json
availablebooleanRequired
enabledbooleanRequired
currencystringRequired
customer_idstring | nullRequired
thresholdnumberRequired

Minimum 0

amountnumberRequired

Minimum 0

payment_methodobject | nullRequired
Show nested fields
Option 1: object
typestringRequired
brandstring | nullRequired
last4string | nullRequired
exp_monthinteger | nullRequired

Minimum 1 · Maximum 12

exp_yearinteger | nullRequired
Option 2: null

null

last_statusstring | nullRequired

Values: "pending""open""processing""paid""failed""expired"null

last_errorstring | nullRequired
last_charged_atstring | nullRequired
401Authentication is missing or invalid.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

403Authenticated principal lacks permission.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

500Internal server error.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.