Skip to main content

Rate Limits

SanctionsWise API implements rate limiting to ensure fair usage and service stability.

Rate Limits by Tier​

TierRate LimitBurst LimitDaily QuotaMonthly Quota
Free1/sec550015,000
Starter5/sec205,000150,000
Professional25/sec10025,000750,000
Enterprise50/sec200100,000+Custom

Understanding Rate Limits​

Rate Limit​

Maximum requests per second sustained over time.

Burst Limit​

Maximum requests allowed in a short burst (useful for batch operations).

Daily Quota​

Maximum requests per 24-hour period (resets at midnight UTC).

Monthly Quota​

Maximum requests per billing period.

Rate Limit Headers​

Every response includes rate limit information:

X-RateLimit-Limit: 5
X-RateLimit-Remaining: 4
X-RateLimit-Reset: 1702234800
HeaderDescription
X-RateLimit-LimitRequests per second for your tier
X-RateLimit-RemainingRemaining requests in current window
X-RateLimit-ResetUnix timestamp when limit resets

Rate Limit Exceeded Response​

When rate limited, you receive a 429 Too Many Requests response:

{
  "message": "Rate limit exceeded",
  "retry_after_seconds": 60
}

The Retry-After header indicates when you can retry:

HTTP/1.1 429 Too Many Requests
Retry-After: 60

Best Practices​

1. Implement Exponential Backoff​

import time

def screen_with_backoff(name, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = screen_entity(name)
            return response
        except RateLimitError as e:
            if attempt < max_retries - 1:
                wait_time = e.retry_after or (2 ** attempt)
                time.sleep(wait_time)
            else:
                raise

2. Use Batch Screening​

For multiple entities, use /screen/batch instead of multiple single requests:

# Instead of 100 single requests...
# Use one batch request with 100 entities
curl -X POST ".../screen/batch" \
  -d '{"entities": [...100 entities...]}'

3. Monitor Your Usage​

Track your API usage at app.orchestraprime.ai:

  • Real-time request counts
  • Daily/monthly usage trends
  • Alerts when approaching limits

4. Cache Results When Appropriate​

For repeated screenings of the same entity:

  • Cache clear results for 24 hours
  • Cache match results until next data update
  • Always re-screen before critical transactions

Upgrading Your Tier​

Need higher limits? Upgrade your subscription:

  1. Visit AWS Marketplace
  2. Or contact sales@orchestraprime.ai for Enterprise plans

Enterprise Custom Limits​

Enterprise customers can negotiate custom limits:

  • Higher requests per second
  • Larger burst capacity
  • Dedicated capacity
  • Custom SLAs

Contact sales@orchestraprime.ai for enterprise pricing.