REST API · JSON · Credit-based
HuntAPI API
HTTP endpoints that return clean, structured data. Authenticate with a single key, pay only for what succeeds.
0
Endpoints
5-10 min
Avg. response
0.9%
Uptime SLA
Quick start
Include your key in the x-api-key header:
$ curl "https://api.huntapi.com/usage" -H "x-api-key: YOUR_API_KEY"Find your key in dashboard → API Keys.
How it works
Credit-based billing
Pay only for successful requests. Failed calls never consume credits.
Single API key
One key to authenticate across every endpoint. No per-service credentials.
Structured JSON
Every response is a typed, consistent JSON object. Predictable by design.
Status Codes
Billing applies to successful requests: 200 for synchronous calls, 201 for asynchronous jobs, and 404 when the resource is not found (unless specified otherwise).
200BilledSuccessful API CallNo action required.201BilledJob CreatedNo action required.202FreeAccepted (Async)The request is being processed. Use the job ID to poll for the result.400FreeBad RequestVerify your parameters and their types. Check the docs for more information.401FreeInvalid API KeyCheck your x-api-key header or x_api_key query string.401FreeInactive API KeyActivate your key in Settings → API Keys.401FreeExpired API KeyUpdate your key or generate a new one in the dashboard.401FreeRate Limit ExceededUpgrade your plan or contact our sales team.402FreePayment RequiredSettle any outstanding invoices to continue using the API.403FreeForbidden / Account deactivatedVerify your permissions. Contact us if you believe this is a mistake.404BilledNot FoundResult not found. Some APIs do not bill 404 — indicated by a badge on the endpoint.500FreeInternal ErrorRetry the request or contact support via the ticket system.