Reference guide for API error codes and rate limiting behavior.
HTTP status codes
Code | Meaning | What to do |
200 | Success | Request completed successfully |
400 | Invalid request | Check your request format and parameters |
401 | Unauthorized | Check your API key. Must use format: |
402 | Insufficient credits | Top up credits via Settings > Billing in the portal |
404 | Not found | Check the endpoint URL |
422 | Validation error | Each contact needs a LinkedIn URL or name + company. Check the error detail field. |
429 | Rate limit exceeded | Implement exponential backoff with jitter and retry |
500 | Server error | Retry after a short delay. Contact support if persistent. |
Rate limits
Rate limits are applied per-organization, per-endpoint. If you receive a 429 response:
Implement exponential backoff with jitter.
Space out your requests.
Contact support if you consistently hit limits during normal use.
Bulk request limits
Maximum 250 contacts per request for the bulk enrichment endpoint. Split larger batches across multiple requests.