API v1

Rate limits

Rate limits are enforced per API key. Each request consumes 1 credit from your monthly pool (shared with widget chat usage).

Limits by plan

Plan	Requests / min	Credits / month	Daily cap	Max keys
Plus	60	1,500	10,000 / chatbot	15
Enterprise	200	Unlimited	50,000 / chatbot	50

Every POST /v1/chat response includes three headers to help you manage request pacing:

X-RateLimit-Limit — maximum requests allowed per minute for your key.
X-RateLimit-Remaining — requests remaining in the current 60-second window.
X-RateLimit-Reset — Unix timestamp (seconds) when the rate-limit window resets.

Check X-RateLimit-Remaining before each request to avoid hitting the limit.
If you receive a 429 response, wait until X-RateLimit-Reset before retrying.
Implement exponential backoff for retries — start at 1 second, double on each attempt, cap at 30 seconds.

Errors

Status codes including 429 — what they mean and how to recover.

Code examples

Reference implementations that read rate-limit headers and back off.