Errors

{
  "error": "Human-readable message"
}

{
  "error": "Invalid industry value",
  "field": "query.industry",
  "invalid_values": ["SaaS"],
  "accepted_values": ["Software Development", "..."]
}

{
  "success": false,
  "code": "BULK_ENRICHMENT_REQUIRED",
  "message": "This request discovers multiple entities and performs paid enrichment for each...",
  "request_id": "req_...",
  "price": 0,
  "credits_used": 0,
  "recommended_workflow": [
    { "endpoint": "/company-search", "purpose": "Build a company list" },
    { "endpoint": "/person-search", "purpose": "Find relevant people" },
    { "endpoint": "/person-email", "purpose": "Find an email for each selected person" }
  ]
}