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

# Rate limits

> Request rate limits enforced by the API.

## Overview

To protect reliability and ensure fair usage, requests to the API are subject to rate limits.

Rate limits are enforced **per API key** and apply across all endpoints.

***

## Limits

The API uses a token-bucket–style rate limiter that allows short bursts while enforcing a sustained
request rate.

**Current limits (subject to change):**

* Burst capacity: approximately **50 requests**
* Sustained rate: approximately **10 requests per second** per API key

***

## Rate limit exceeded (429)

When a request exceeds the rate limit, the API responds with `429 Too Many Requests`.

### Example response

```http theme={null}
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 1

{
  "title": "Too many requests",
  "status": 429,
  "detail": "Rate limit exceeded",
  "instance": "/v1/address"
}
```
