Skip to content

Check your balance

GET
/v1/balance
curl --request GET \
--url https://api.disasm.dev/v1/balance \
--header 'Authorization: Bearer <token>'

Quick balance check. Returns your PAYG wallet balance and per-key subscription request balances.

Balance summary.

Media typeapplication/json
object
payg_balance_pence

Pay-as-you-go wallet balance, in pence.

integer
total_request_balance

Total subscription requests remaining across all keys.

integer
keys
Array<object>
object
id
string
label
string
key_hint

Masked key, for identification only.

string
request_balance

Subscription requests remaining on this key.

integer
service_id
integer

Example

{
"payg_balance_pence": 4500,
"total_request_balance": 8250,
"keys": [
{
"id": "key-uuid-1",
"label": "Incapsula",
"key_hint": "dk_live_****abcd",
"request_balance": 5000,
"service_id": 1
},
{
"id": "key-uuid-2",
"label": "DataDome",
"key_hint": "dk_live_****efgh",
"request_balance": 3250,
"service_id": 2
}
]
}
X-RateLimit-Limit
integer
Example
60

Maximum requests per minute (60).

X-RateLimit-Remaining
integer
Example
59

Requests remaining in the current window.

X-RateLimit-Reset
integer
Example
1718000000

Unix timestamp when the rate limit resets.

X-Balance-Remaining
integer
Example
8250

Total subscription request balance across all keys.

X-PAYG-Balance
integer
Example
4500

PAYG wallet balance in pence.

Missing or invalid API key.

Media typeapplication/json
object
error

A human-readable message describing what went wrong.

string

Example

{
"error": "Missing or invalid API key"
}

Rate limit exceeded. See the X-RateLimit-* response headers.

Media typeapplication/json
object
error

A human-readable message describing what went wrong.

string

Example

{
"error": "Rate limit exceeded"
}
X-RateLimit-Limit
integer
Example
60

Maximum requests per minute (60).

X-RateLimit-Remaining
integer
Example
59

Requests remaining in the current window.

X-RateLimit-Reset
integer
Example
1718000000

Unix timestamp when the rate limit resets.