Skip to main content
GET
/
v3
/
billing
/
balance
curl
curl -X GET 'https://verification.didit.me/v3/billing/balance/' \
  -H 'x-api-key: YOUR_API_KEY'
{ "balance": "1234.5600", "auto_refill_enabled": true, "auto_refill_amount": "500.00", "auto_refill_threshold": "100.00" }

Authorizations

x-api-key
string
header
required

Response

Current credit balance plus the organization's auto-refill configuration.

balance
string
required

Current pre-paid credit balance in USD, as a fixed-point decimal string. Decreases as verifications are billed and increases when a top-up settles.

auto_refill_enabled
boolean
required

When true, Didit will automatically charge the saved Stripe payment method to add credits once the balance crosses auto_refill_threshold. Configured from Console → Billing.

auto_refill_amount
string | null

USD amount that will be charged on each auto-refill. null when auto-refill is disabled or unset.

auto_refill_threshold
string | null

Trigger threshold in USD. Auto-refill fires when balance falls below this value. null when auto-refill is disabled or unset.