Skip to main content

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

ResourceEndpoints
EventsGET /v1/events · GET /v1/events/search · GET /v1/events/count · GET /v1/events/timeseries · GET /v1/events/facets · GET /v1/events/{id}
TracesGET /v1/traces
SignalsGET /v1/signals · GET /v1/signals/{id}
UsersGET /v1/users · GET /v1/users/{id}
ConversationsGET /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