Analytics

Overview

The analytics endpoint returns aggregated usage statistics for your gateway. All requests require a valid Bearer token.

Endpoint: GET /v1/analytics

Authentication: Required

Request

GET https://your-gateway.workers.dev/v1/analytics
Authorization: Bearer <your-token>

No query parameters are required. The response covers all-time aggregated data.

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
    },
    "groq": {
      "requests": 3223,
      "successful": 2871,
      "failed": 352
    }
  },
  "models": {
    "gpt-4o": {
      "requests": 3100,
      "successful": 3080,
      "failed": 20
    },
    "claude-3-5-sonnet-20241022": {
      "requests": 2800,
      "successful": 2700,
      "failed": 100
    },
    "llama-3.3-70b-versatile": {
      "requests": 1600,
      "successful": 1450,
      "failed": 150
    }
  }
}

Response Fields

Field	Type	Description
total_requests	number	Total number of requests handled by the gateway
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

curl https://your-gateway.workers.dev/v1/analytics \
  -H "Authorization: Bearer <your-token>"

JavaScript

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

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`);
}