# API Rate Limits

Our primary goal is to provide a reliable and consistent service to all our users. By implementing these rate limits, we aim to:

* **Ensure fair usage**: Prevent any single user from consuming excessive resources.
* **Improve performance**: Maintain high performance and availability for all users.
* **Enhance stability**: Reduce the likelihood of service interruptions and downtime.

**Here are some common aspects of API rate limits:**

1. **Request Limit**: The maximum number of requests allowed within a specified period (e.g., per minute, hour, or day).
2. **Burst Limit**: The maximum number of requests allowed in a short burst. This is usually higher than the sustained request limit but applies over a much shorter time frame.
3. **Quota Limit**: A cumulative limit over a longer period, such as the total number of requests allowed per month.
4. **User/IP Limits**: Limits that apply per user or per IP address to prevent a single user or IP from consuming excessive resources.
5. **Endpoint-specific Limits**: Different limits for different API endpoints based on their resource intensity or importance.
6. **Concurrent Requests Limit**: The maximum number of concurrent API calls that can be made.

When the rate limit is exceeded, the API typically responds with an `HTTP status code`such as `429 Too Many Requests.` The response may include information about when the rate limit will reset and how long to wait before making additional requests.

## Default Rate Limits

<table><thead><tr><th width="129">API</th><th>Endpoint</th><th width="243">Rate Limit</th><th>Description</th></tr></thead><tbody><tr><td>REST</td><td>/sms/send</td><td><ul><li>600 RPM or 10 RPS</li><li>Submit up to 100 Numbers Per Request</li></ul></td><td> Global Limit</td></tr><tr><td>REST</td><td>/sms/status</td><td>600 RPM or 10 RPS</td><td> Global Limit</td></tr><tr><td>REST</td><td>/account/balance</td><td>60 RPM or 1 RPS</td><td> Global Limit</td></tr><tr><td>SMPP</td><td>Send SMS</td><td>10 TPS</td><td>Adjustable Limit</td></tr></tbody></table>

## Abbrivations

<table><thead><tr><th width="208">Term</th><th>Description</th></tr></thead><tbody><tr><td>API</td><td>Application Programming Interface</td></tr><tr><td>HTTP</td><td>Hypertext Transfer Protocol</td></tr><tr><td>REST API</td><td>Representational State Transfer Application Programming Interface</td></tr><tr><td>SMPP</td><td>Short Message Peer-to-Peer Protocol</td></tr><tr><td>IP</td><td>Internet Protocol</td></tr><tr><td>X-RateLimit-Limit</td><td>Maximum no. of requests allowed in the current period</td></tr><tr><td>RPM</td><td>Requests Per Minute</td></tr><tr><td>RPS</td><td>Requests Per Second</td></tr><tr><td>TPS</td><td>Transactions Per Second</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.unecast.com/api-rate-limits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
