Reference

API Rate Limits

Rate limits for the Wraps Platform API by plan. Includes response headers and error handling.

Limits by Plan

The Wraps Platform API enforces per-minute and daily rate limits based on your plan. Limits are applied per organization using DynamoDB-backed sliding windows.

Plan	Per Minute	Per Day
Free	`50` requests	`1,000` requests
Starter	`500` requests	`50,000` requests
Growth	`2,000` requests	`200,000` requests
Scale	`5,000` requests	`500,000` requests

Public Endpoints

Unauthenticated endpoints (health check, public tools) use IP-based rate limiting:

Scope	Limit
Per minute per IP	`10` requests
Per hour per IP	`100` requests

Response Headers

Every API response includes rate limit headers so you can track your usage:

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed in the current window
`X-RateLimit-Remaining`	Requests remaining in the current window
`Retry-After`	Seconds to wait before retrying (only on 429 responses)

Successful response

Rate limited response (429)

Handling 429 Errors

When you receive a 429 status code:

Read the Retry-After header for the number of seconds to wait
Wait that duration before retrying
Use exponential backoff if retries continue to fail

Next Steps

Error Codes

Complete reference for CLI and SDK error codes.

View Error Codes

SDK Reference

Full API reference for the Email SDK.

View SDK Reference