API Reference

Open API Reference

Interactive API documentation with request builder

Base URL

https://query.raindrop.ai

Authentication

All requests require a Bearer token:

curl https://query.raindrop.ai/v1/events \
  -H "Authorization: Bearer YOUR_QUERY_API_KEY"

Projects

Reads are scoped to a single project by default. Requests resolve to your org’s Production project (slug default) unless you send a project slug in the X-Raindrop-Project-Id header:

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. You can also pass * — the All projects view — to read across every active project at once, optionally narrowed with project_ids (comma-separated slugs, each naming an active project). Rows returned in this scope carry a per-row project_id. Endpoints that don’t support the all-projects scope reject * with a 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

Getting Started

SDK

Integrations

Platform

Organization

Workshop

Query API

MCP

Security

Support

Open API Reference

Base URL

Authentication

Projects

Endpoints

Rate Limits

Open API Reference

​Base URL

​Authentication

​Projects

​Endpoints

​Rate Limits

Base URL

Authentication

Projects

Endpoints

Rate Limits