> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate Limiting

> Understand the rate limiting policies for the Vantage API to ensure optimal usage and avoid interruptions.

API calls are rate limited to prevent bursts of incoming traffic to help maximize stability. These limits are account-wide rather than per-user restrictions, meaning all API activity within your Vantage account contributes to these thresholds.

These limits include a general rate limit of 1,000 requests per hour across all API endpoints, and a more restrictive limit of 5 requests per 5 seconds, specifically for Cost Report endpoints. If a client is rate limited, the API will return a `429` status code. If you need higher rate limits, contact [support@vantage.sh](mailto:support@vantage.sh).

Three headers are returned with every API response that indicate how close the client is to being rate limited and when the limit will reset.

| Header                   | Description                                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `x-rate-limit-limit`     | The total limit for the given period of time.                                                                                                                  |
| `x-rate-limit-remaining` | The number of requests remaining in the current rate limit window.                                                                                             |
| `x-rate-limit-reset`     | The time at which the current rate limit window resets to the value in `x-rate-limit-limit`, provided in [Unix time](https://en.wikipedia.org/wiki/Unix_time). |

**Example:**

```bash theme={null}
x-rate-limit-limit: 1000
x-rate-limit-remaining: 995
x-rate-limit-reset: 1619380800
```