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

# API Reference

> Explore the Query API endpoints

<Card title="Open API Reference" icon="arrow-up-right-from-square" href="https://query.raindrop.ai/v1/docs">
  Interactive API documentation with request builder
</Card>

## Base URL

```
https://query.raindrop.ai
```

## Authentication

All requests require a Bearer token:

```bash theme={null}
curl https://query.raindrop.ai/v1/events \
  -H "Authorization: Bearer YOUR_QUERY_API_KEY"
```

## Projects

Reads are scoped to a single [project](/platform/projects). Requests resolve to your org's **Production** project (slug `default`) unless you send a project slug in the `X-Raindrop-Project-Id` header:

```bash theme={null}
curl https://query.raindrop.ai/v1/events \
  -H "Authorization: Bearer YOUR_QUERY_API_KEY" \
  -H "X-Raindrop-Project-Id: support-prod"
```

Single-project orgs can omit the header. An archived or unknown project returns `403`; a malformed slug returns `400`.

## Endpoints

| Resource          | Endpoints                                                                                                                                           |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Events**        | `GET /v1/events` · `GET /v1/events/search` · `GET /v1/events/count` · `GET /v1/events/timeseries` · `GET /v1/events/facets` · `GET /v1/events/{id}` |
| **Traces**        | `GET /v1/traces`                                                                                                                                    |
| **Signals**       | `GET /v1/signals` · `GET /v1/signals/{id}`                                                                                                          |
| **Users**         | `GET /v1/users` · `GET /v1/users/{id}`                                                                                                              |
| **Conversations** | `GET /v1/conversations` · `GET /v1/conversations/{id}`                                                                                              |

## Rate Limits

* **200 RPM** for most endpoints
* **50 RPM** for `GET /v1/events/search`
* **20 RPS** across all endpoints