Billing
Get your auto top-up configuration
Returns your current auto top-up state. When enabled is true, the
response includes the recurring top-up option, the per-charge amount, the
threshold floor, and a best-effort next_charge_at.
next_charge_at is null when auto top-up is off or when the upstream
lookup is briefly unavailable; this read never fails because of a
payment-processor outage.
Requires the billing:write scope.
AuthorizationBearer <token>
Authenticate by sending your API key as a bearer token:
Authorization: Bearer am_live_.... Every request is automatically
scoped to the organization that owns the key and to the scopes granted
to that key.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/billing/wallet/auto-topup"{
"success": true,
"data": {
"enabled": false,
"next_charge_at": null
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "authentication failed",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "missing required scope",
"request_id": "01JTBQH2FZ8K1RXC0WJ4Z9P3VM"
}
}