Usage & Limits

Error Handling

The API uses standard HTTP codes. Handle these cases:

Status	Meaning	Fix
401 Unauthorized	Missing/invalid API key	Send `Authorization: Bearer <key>` and verify the key is active
404 Not Found	Logo/company not found	Verify domain/id, handle with a fallback logo
429 Too Many Requests	Rate limit or quota exceeded	Respect `Retry-After`, back off, or upgrade plan
500/503	Temporary server issue	Retry with backoff; contact support if persistent

Sample 429 response


Code
 
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "details": {
      "retryAfter": 2,
      "suggestion": "Back off and retry after the window resets"
    }
  }
}

Check x-request-id in responses when contacting support.

Last modified on December 4, 2025

Rate Limits

Usage & Limits

Error Handling

The API uses standard HTTP codes. Handle these cases:

Status	Meaning	Fix
401 Unauthorized	Missing/invalid API key	Send `Authorization: Bearer <key>` and verify the key is active
404 Not Found	Logo/company not found	Verify domain/id, handle with a fallback logo
429 Too Many Requests	Rate limit or quota exceeded	Respect `Retry-After`, back off, or upgrade plan
500/503	Temporary server issue	Retry with backoff; contact support if persistent

Sample 429 response


Code
 
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "details": {
      "retryAfter": 2,
      "suggestion": "Back off and retry after the window resets"
    }
  }
}

Check x-request-id in responses when contacting support.

Last modified on December 4, 2025

Rate Limits