Skip to main content
Huntr returns JSON error bodies with an error string. Some responses include structured fields for programmatic handling.

Common status codes

Standard error shape

Query validation (search endpoints)

Company and person search return detailed validation errors for bad filters:
Use accepted_values to fix exact lookup fields like services, industry, country_code, number_of_employees, and revenue.

Bulk enrichment rejection

When /research cannot run a multi-entity enrichment workflow within budget:
Follow recommended_workflow.

Research failures

Async failures include error and optional error_code on the status endpoint.

Next step