Skip to main content
Error responses use a stable JSON envelope. 
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_request",
    "message": "The request body is invalid.",
    "param": "filters",
    "request_id": "req_abc123"
  }
}

​
Status codes

StatusMeaning
400Invalid request body, query parameter, cursor, ID, or filter combination.
401Missing, invalid, or revoked API key.
402Not enough contact credits for a reveal request.
403API access is not enabled for the account, plan, key, or entitlement.
404The requested resource was not found.
409Idempotency conflict or request state conflict.
429Monthly quota, search-row quota, or request rate limit exceeded.
500Unexpected server error.

​
Support

When reporting an issue, include the request_id from the response body or X-Request-Id header.