v66

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0174265626.3 KB
analytics

Query rate limit data

Queries may reference only the five public rate limit analytics aliases: ratelimits_v1, ratelimits_per_minute_v1, ratelimits_per_hour_v1, ratelimits_per_day_v1, or ratelimits_per_month_v1. CTEs, subqueries, UNION, and EXCEPT are supported. Queries are always restricted to the authenticated workspace. Wildcard analytics permission can read every namespace in that workspace; namespace-scoped permissions automatically restrict results to the permitted namespace IDs. Workspace retention and query limits apply.

post/v2/analytics.getRatelimits

Request body

querystring required

SQL query to execute against your rate limit analytics data. Queries may reference only the five public aliases: ratelimits_v1, ratelimits_per_minute_v1, ratelimits_per_hour_v1, ratelimits_per_day_v1, or ratelimits_per_month_v1. Physical default.* table names are unsupported. CTEs, subqueries, UNION, and EXCEPT are supported. Queries are always restricted to the authenticated workspace. Wildcard analytics permission can read every namespace in that workspace; namespace-scoped permissions automatically restrict results to the permitted namespace IDs. Workspace retention and query limits apply.

Example request

{
  "query": "SELECT namespace_id, COUNT(*) AS total FROM ratelimits_v1 WHERE namespace_id = 'rlns_123' GROUP BY namespace_id"
}

Response

Query executed successfully

dataobject[] required

Array of rate limit rows returned by the query. Fields vary based on the SQL SELECT clause.

Example response

{
  "meta": {
    "requestId": "req_123"
  },
  "data": [
    {
      "namespace_id": "rlns_123",
      "total": 1234
    }
  ]
}
All 74 operations