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

# Saytics REST API: Base URL, Rate Limits, and Errors

> The Saytics REST API lets you track events, manage users, and query reports programmatically. Explore base URLs, authentication, and rate limits.

The Saytics REST API gives you programmatic access to all platform functionality — track events from any language or framework, query reports, and manage user data without touching the dashboard.

## Base URL

All API requests are made to the following base URL:

```
https://api.saytics.com/v1
```

## Authentication

Every request to the Saytics API must include your API key in the `Authorization` header. See the [authentication guide](/api-reference/authentication) for details on key types and how to find your keys.

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Rate limits

Rate limits apply per API key and vary by plan.

| Plan       | Requests/minute | Batch size   |
| ---------- | --------------- | ------------ |
| Free       | 100             | 100 events   |
| Starter    | 500             | 500 events   |
| Pro        | 2,000           | 1,000 events |
| Enterprise | Custom          | Custom       |

When you exceed your rate limit, the API returns a `429` status code. Wait until the next minute window before retrying.

## Response format

All responses use JSON. A successful response includes a `status` field; error responses include an `error` object with a `code` and `message`.

```json theme={null}
// Success
{
  "status": "ok",
  "received": 1
}

// Error
{
  "error": {
    "code": "invalid_key",
    "message": "The provided API key is invalid or revoked."
  }
}
```

## HTTP status codes

| Code | Meaning                                   |
| ---- | ----------------------------------------- |
| 200  | Success                                   |
| 400  | Bad request — check your request body     |
| 401  | Unauthorized — invalid or missing API key |
| 429  | Rate limit exceeded                       |
| 500  | Server error — contact support            |

## Versioning

The current API version is `v1`, reflected in the base URL. When breaking changes are introduced, Saytics will notify you by email and post details in the changelog before the change takes effect.