200 | Read succeeded. | None. |
202 | Search or enrichment accepted, or an idempotent retry returned its existing job. | Store job_id and poll the matching endpoint family. |
401 | Missing, invalid, or revoked API key. | Fix or rotate the key; do not retry blindly. |
402 | Insufficient credits or inactive paid subscription. | Reduce the request if the balance allows, or update the plan. |
403 | Free, plan, or product job-size limit exceeded. | Lower maxResults or the number of submitted businesses. |
404 | Search or enrichment job not found for the authenticated account. | Verify the job ID, endpoint family, and API-key owner. |
409 | Idempotency key was reused with a different request. | Restore the original body or use a new key for a genuinely new job. |
422 | Query, path, or JSON body validation failed, including maxResults below 100. | Correct the request fields. |
428 | Production job creation omitted Idempotency-Key. | Add a stable key and retry. |
429 | Request limit or active-search concurrency limit reached. | Honor Retry-After; retry with backoff and jitter. |
503 | A required production service is unavailable. | Retry later with the same idempotency key for creation. |