Analytics

Retrieve aggregated usage statistics for a specific project — request counts, success/failure rates, and breakdowns by provider and model.

Overview

The analytics endpoint returns aggregated usage statistics for your gateway — request volume, success/failure rates, and breakdowns by provider, model, project, and day. Aggregates are stored in Cloudflare D1. It exposes operational load data, so all requests require a valid GATEWAY_API_KEY Bearer token; without one the gateway returns 401.

Endpoint: GET /v1/analytics

Authentication: Required (GATEWAY_API_KEY)

Request

GET https://your-gateway.workers.dev/v1/analytics?project_id=proj_abc123
Authorization: Bearer <GATEWAY_API_KEY>

Query Parameters

Parameter	Type	Required	Description
`project_id`	string	No	Filter analytics to a single project. Omit for all-project totals.
`days`	number	No	Restrict to the last N days (1–365). Omit for all time.

Response

{
  "total_requests": 14823,
  "successful_requests": 14201,
  "failed_requests": 622,
  "success_rate": 0.958,
  "providers": {
    "openai": {
      "requests": 6400,
      "successful": 6350,
      "failed": 50
    },
    "anthropic": {
      "requests": 5200,
      "successful": 4980,
      "failed": 220
    }
  },
  "models": {
    "gpt-4o": {
      "requests": 3100,
      "successful": 3080,
      "failed": 20
    }
  }
}

Response Fields

Field	Type	Description
`total_requests`	number	Total number of requests handled by the gateway for this project
`successful_requests`	number	Requests that returned a 2xx response
`failed_requests`	number	Requests that returned a non-2xx response
`success_rate`	number	Ratio of successful to total requests (0–1)
`providers`	object	Per-provider breakdown of request counts
`models`	object	Per-model breakdown of request counts

Examples

curl "https://your-gateway.workers.dev/v1/analytics?project_id=proj_abc123" \
  -H "Authorization: Bearer <GATEWAY_API_KEY>"

const response = await fetch('https://your-gateway.workers.dev/v1/analytics?project_id=proj_abc123', {
  headers: {
    'Authorization': 'Bearer <GATEWAY_API_KEY>',
  },
});

const stats = await response.json();

console.log(`Total requests: ${stats.total_requests}`);
console.log(`Success rate: ${(stats.success_rate * 100).toFixed(1)}%`);

for (const [provider, data] of Object.entries(stats.providers)) {
  console.log(`${provider}: ${data.requests} requests`);
}