Rate Limits & Errors

Rate Limits

The Fiscal.ai API enforces rate limits to ensure fair usage and maintain service quality for all users.

Free Plan

When you exceed the short burst limit, the API returns a 429 status code:

{
  "error": "Rate limit exceeded for free trial."
}

When you exceed the daily limit, the API returns a 429 status code:

{
  "error": "Daily request limit exceeded for free trial"
}

Your limit resets at midnight UTC each day.

Paid Plans

Paid plans have higher rate limits based on your subscription tier. Contact our sales team for details on rate limits for your specific plan.

HTTP Status Codes

The API uses standard HTTP status codes to indicate the success or failure of requests.

Success Codes

Error Codes

Error Response Format

All error responses follow this format:

{
  "error": "Error message describing what went wrong"
}

Common Error Messages

Authentication Errors (401)

{
  "error": "Invalid API key"
}

Missing Parameters (400)

{
  "error": "Missing required parameters: either Company Key, CUSIP, ISIN, FIGI, or Ticker + Exchange"
}

Company Not Found (404)

{
  "error": "Company not found"
}

Feature Access (403)

{
  "error": "You do not have access to this feature"
}

{
  "error": "This company is not available for the free trial."
}

CUSIP/ISIN License (403)

{
  "error": "CUSIP/ISIN license is required, please contact sales at https://fiscal.ai/contact-sales"
}

Rate Limit Exceeded (429)

{
  "error": "Daily request limit exceeded for free trial"
}

Best Practices

1. Cache responses - Financial data doesn't change frequently. Cache responses to reduce API calls.

2. Handle 429 errors gracefully - Implement exponential backoff when you hit rate limits.

3. Check for errors first - Always check the HTTP status code before parsing the response body.

4. Use company keys - Using companyKey directly is faster than looking up by ticker/exchange.

API Status

Check our live API status and subscribe to incident notifications: