Billing API

Check your balance, view top-up history, and understand how graduated volume pricing works.

Get Balance

GET/v1/balance

curl

curl https://api.voxparse.com/v1/balance \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "balance_cents": 4250,
  "balance_dollars": "42.5000",
  "expired": false,
  "recent_topups": [...]
}

Volume Pricing Tiers

Graduated pricing applies automatically based on your monthly usage. Each band is priced separately, like tax brackets:

Monthly Band	Rate	Savings
First 250 hours	$0.49/hr	Base rate
Hours 251 - 1,000	$0.45/hr	8% off
Hours 1,001+	$0.39/hr	20% off

Example: 2,000 hours in a month costs: (250 x $0.49) + (750 x $0.45) + (1,000 x $0.39) = $122.50 + $337.50 + $390.00 = $850.00 (effective rate: $0.425/hr)

Top-up Products

GET/billing/products

Lists available prepaid top-up amounts. No authentication required. Credits expire after 6 months of account inactivity.