API Reference - Raindrop

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. 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.

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

Open API Reference

​Base URL

​Authentication

​Projects

​Endpoints

​Rate Limits

Base URL

Authentication

Projects

Endpoints

Rate Limits