Default Rate Limits

By default, every organization is allowed 1,000 requests per minute, and 40,000 requests per day. If your organization's needs exceed these limits, please contact us at developers@mothership.com.

Response Headers

Every API response includes the following rate limiting headers.

Header	Description
X-RateLimit-Limit	The maximum number of requests for the current time window.
X-RateLimit-Remaining	The number of requests remaining for the current time window.
X-RateLimit-Reset	A unix timestamp representing when the request counter resets.

Limit Exceeded

If you exceed your rate limit, the API will respond with HTTP status code 429 and the header Retry-After, indicating the number of seconds to wait before trying again.

HTTP/1.1 429 TOO MANY REQUESTS
Content-Type: application/json
Retry-After: 43200