§05 / rate limits

Rate limits

Three sliding windows per short code: hourly, daily, and monthly. All three run simultaneously.

§01

How the windows work

Each window is a sliding count. The hourly window counts requests in the last 60 minutes; the daily window counts the last 24 hours; the monthly window counts the last 30 days. Hitting any one of the three limits blocks further requests until that window clears.

§02

Your key mode limits

Limits are set by your subscription tier. PAYG-only (no active subscription, PAYG enabled) runs at Taster-level limits.

mode/your-key
TierHourlyDailyMonthly
Taster105030
Basic1002,00010,000
Pro50010,000100,000
PAYG only105030
§03

Hosted mode limits

mode/hosted

Hosted mode runs at Pro-equivalent limits: 500 req/h, 10,000 req/d, 100,000 req/mo. There is no subscription quota — only the rate-limit windows apply.

§04

What a 429 means

A 429 response means one of your three windows is full. The response includes a Retry-After header indicating when the blocking window clears. Your client may surface this as a generic error — check the response body for the reAPI error message.

§faq

Common questions

  • Q.01

    When does my monthly quota reset?

    The monthly window is a rolling 30-day count, not a calendar-month reset. It clears 30 days after the oldest request in the window.

  • Q.02

    What does the 429 error message say?

    The response body includes a JSON error with a message field describing which window was hit (hourly, daily, or monthly) and a link to your dashboard.

  • Q.03

    Can I see my current usage?

    The Overview page shows your current-period request-unit usage against your quota. Detailed per-request logs are on the Activity page.