Skip to main content
GET
/
balance
Check balance & rate limit
curl --request GET \
  --url https://api.tryhuntr.com/balance \
  --header 'x-api-key: <api-key>'
{
  "email": "you@company.com",
  "credits": 4.89,
  "rate_limit": {
    "remaining": 28,
    "reset": 1746127200000
  },
  "total_spent": 0.1,
  "pricing_plan": "default"
}

Authorizations

​
x-api-key
string
header
required

Your Huntr API key. Get one at tryhuntr.com. Pass as x-api-key header on all authenticated requests.

Response

Account balance and rate limit state.

​
email
string

Email address associated with this API key.

​
credits
number

Current balance in USD. Deducted on each successful research request at the tier price.

​
rate_limit
object

Current rate limit snapshot. Also returned as X-RateLimit-Remaining and X-RateLimit-Reset response headers.

​
total_spent
number

Cumulative USD spent across all requests on this key.

​
pricing_plan
string

Active standalone scraping pricing plan for this key. default means standard scraping rates.