Get Billing Alert

GET/v1/billing/alert

Returns the current low balance alert settings for the authenticated account.

Authentication

Authorization Bearer

Send an API key (sk-...) in the Authorization header.

Response

codeinteger

Response status code.

dataobject

Low balance alert settings.

data.coupon_availablenumber

Available coupon / credit balance.

data.total_spendablenumber

Current spendable balance.

data.enabledboolean

Whether low balance warning emails are enabled.

data.last_notified_atstring | null

Last notification time.

data.last_recovered_atstring | null

Last recovery time after balance moved back above threshold.

data.thresholdnumber

Alert threshold in USD.

data.wallet_availablenumber

Available wallet balance.

Error Handling

  • 401 / unauthenticated: missing or invalid Authorization.
  • Enterprise member accounts cannot use wallet alert APIs directly.

Request

Shell
1curl -sS "https://api.token360.ai/v1/billing/alert" \
2  -H "Authorization: Bearer sk-your-api-key"

Response

JSON
1{
2  "code": 200,
3  "data": {
4    "coupon_available": 0e-10,
5    "total_spendable": 125.5,
6    "enabled": false,
7    "last_notified_at": null,
8    "last_recovered_at": null,
9    "threshold": 50.0,
10    "wallet_available": 125.5
11  },
12  "msg": "success",
13  "service_code": null,
14  "trace_id": "trace_example_123"
15}
Was this page helpful?