Status Codes
HTTP status codes returned by the HuntAPI API and how to handle them.
Billing applies to successful requests: 200 for synchronous calls, 201 for asynchronous jobs, and 404 when the resource is not found (unless specified otherwise in the API documentation).
| Code | Billed | Status | Action |
|---|---|---|---|
200 | Yes | Successful API Call | No action required. |
201 | Yes | Job Created | No action required. |
202 | No | Accepted (Async) | The request was accepted and is being processed. Use the job ID to check the status. |
400 | No | Bad Request | Verify your parameters and their types. Check the documentation for more information. |
401 | No | Invalid API Key | Check your API key (x-api-key header or x_api_key query string). |
401 | No | Inactive API Key | Activate your API key in the API Keys section of your account settings. |
401 | No | Expired API Key | Update your API key or generate a new one. |
401 | No | Rate Limit Exceeded | Consider upgrading your current plan or contact our sales team. |
402 | No | Payment Required | Settle any outstanding invoices to continue using the API. |
403 | No | Forbidden | Verify your permissions. Contact us if you believe this is a mistake. |
404 | Yes | Not Found | Result not found for this request. Some APIs do not bill 404. |
500 | No | Internal Error | Retry the action or contact our support team. |