Reference
Rate limits
Each API key can make 600 requests in any 60-second window. The pricing endpoints are public and not counted against a key.
| Header | Meaning |
|---|---|
| X-RateLimit-Limit | Requests allowed per window (600). |
| X-RateLimit-Remaining | Requests left in the current window. |
| X-RateLimit-Reset | Seconds until the oldest request leaves the window. |
| Retry-After | On 429 only: seconds to wait. |
Sending large volumes
Batches make the limit generous: 600 batch requests of 10,000 numbers is millions of messages per minute of requests. The queue then hands messages to the network at up to 1,200 per minute per account, in the order they were accepted.
When you hit the limit
{
"error": {
"code": "rate_limited",
"message": "This key made more than 600 requests in the last minute. Retry after 12 seconds.",
"doc_url": "https://bulksmsapi.cc/en/docs/errors#rate_limited"
}
}