Errors & Rate Limits

Understand how FalakAPI handles errors and rate limiting to build robust applications.

HTTP Status Codes

Code	Meaning	Description
200	OK	Request successful
400	Bad Request	Invalid parameters or malformed request
401	Unauthorized	Missing or invalid API key
403	Forbidden	API key valid but access denied
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server error (rare)

Error Response Format

All error responses follow a consistent format:

{
  "error": "Error message describing what went wrong",
  "code": "ERROR_CODE",
  "details": {
    "field": "Additional error details if applicable"
  }
}

Rate Limits

Rate limits vary by plan:

Free: 5,000 requests per month
Starter: 25,000 requests per month
Pro: 100,000 requests per month
Enterprise: Custom quota

When you exceed your rate limit, you'll receive a 429 Too Many Requests response.