Rate limits and quotas
Your approved subscription defines the number of connections and active customers, company-wide sending allowance, per-number sending allowance, hourly sending rate, API-request allowance, and active webhook endpoints per customer.
Shared company quotas
The company allowance aggregates usage across the company and all its customers, regardless of how many API keys are issued. Creating another customer or key does not create a new company allowance.
Sending allowances
- A sending attempt consumes allowance when the sending operation is created, including attempts that later fail during transport. Rejected requests before operation creation do not consume sending allowance.
- Replaying a completed request with the same idempotency key does not consume a second sending allowance, but it counts as another API request.
- Per-number usage is tied to the verified WhatsApp identity. Reconnecting the same number under a new connection ID does not reset its usage.
- Hourly sending limits and recipient-specific OTP limits apply independently of monthly subscription allowances.
Billing periods
A subscription period is one month from activation. An early renewal with the same plan and limits extends expiration without resetting usage before the next period begins. Expiration or suspension blocks API access immediately; scheduled maintenance subsequently disconnects inactive service sessions.
Custom plans
For more than 10 numbers, request a custom plan and specify the required count. Jawib reviews capacity and provides an approved price and limits before manual payment confirmation and activation. Changing an administrative capacity setting does not add server resources.
Rate-limit responses
When a response includes Retry-After, wait for at least that interval before retrying. A limit without a short retry interval may require a new subscription period, plan review, or capacity review.
Retention
Captured content and media are retained according to the privacy policy, with a default retention period of 30 days. After expiration, media downloads and interactions with old messages may become unavailable. Subscription allowances do not guarantee delivery or read receipts from WhatsApp.