Errors

WhiteBridge API uses standard HTTP response codes to indicate request outcomes:

• 2xx - Success
• 4xx - Client errors (invalid requests)
• 5xx - Server errors (rare)

Error Codes

Code	Description
200	Success
204	Success (no content)
400	Bad request - missing or invalid parameters
401	Unauthorized - invalid or missing API key
404	Not found - resource doesn't exist
429	Rate limit exceeded - reduce request frequency
500	Server error - something went wrong on our end

Error Response Format

{
  "success": false,
  "error": "Error message"
}

Rate Limiting

When you exceed rate limits, you'll receive a 429 response:

{
  "success": false,
  "message": "Rate limit exceeded."
}

We recommend implementing exponential backoff when handling 429 errors.