LOCK

Rate limits & quotas

Every Meridian API key is subject to per-minute request and token limits. Limits scale with your plan and reset on a rolling 60-second window.

TierRPMTPMBurstConcurrent
Partner / Unlimited10,00010,000,0003× baseline for 30 s100
Production1,0001,000,0002× baseline for 15 s25
Trial60100,0005

Handling 429 responses

When you exceed a limit, Meridian returns HTTP 429 Too Many Requests. The response body includes a JSON error object:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "RPM limit reached. Retry after 12 s.",
    "retry_after_seconds": 12
  }
}
  • Read the retry_after_seconds field and sleep before retrying.
  • Implement exponential backoff with jitter to avoid thundering herd.
  • Monitor the x-ratelimit-remaining-requests and x-ratelimit-remaining-tokens response headers to stay under limits proactively.