Details on the rate limits applied to API requests based on subscription plans.
Understanding Rate Limits
To ensure fair usage and protect your account, WasenderAPI applies rate limits based on your plan and account protection settings.
Rate Limit Headers
Every API response includes the following headers to help you track your usage:
X-RateLimit-Limit
: The maximum number of requests allowed in the current window.X-RateLimit-Remaining
: The number of requests left before hitting the limit.X-RateLimit-Reset
: The Unix timestamp (in seconds) when your limit resets.
Rate Limit Rules
Plan | Requests per Minute | Notes |
---|---|---|
Trial | 1 | 1 message per minute |
Basic / Pro / Enterprise | Unlimited | Unless Account Protection is enabled |
Account Protection Limits
If you enable Account Protection, a global limit of 1 message every 5 seconds is applied to help prevent bans from WhatsApp.
⚠️ Repeated abuse of rate limits may lead to temporary API suspension or account review.
Parameters
Name | Type | Required | Description |
---|---|---|---|
X-RateLimit-Limit | integer | No | The maximum number of requests allowed per time window. |
X-RateLimit-Remaining | integer | No | The number of requests remaining in the current time window. |
X-RateLimit-Reset | integer | No | The time in seconds until the rate limit resets. |
Content-Type | string | No | Usually `application/json`. |
Response Examples
{
"message": "You are on a free trial. You can only send 1 message every 1 minute.",
"retry_after": 60
}