Analytics

Analytics endpoints are available on all paid plans.

Required permission: analytics:read

Overview

GET /v1/analytics/overview

Returns account-level counts and API usage for the current day.

{
  "total_keys":        145,
  "active_keys":       138,
  "total_activations": 412,
  "activations_today": 7,
  "expiring_soon":     3,
  "api_calls_today":   214,
  "api_calls_limit_today": 10000
}

Activation trend

GET /v1/analytics/activations?range=7d&product_id=

Param	Values	Default
range	7d, 30d, 90d	7d
product_id	Optional product filter	all products

Returns an array of { date, activations } objects, zero-filled for days with no activity, in ascending date order.

[
  { "date": "2026-08-10", "activations": 3 },
  { "date": "2026-08-11", "activations": 0 },
  { "date": "2026-08-12", "activations": 7 }
]

Geography

GET /v1/analytics/geography

Returns activation counts by country, sorted descending.

[
  { "country": "US", "activations": 142 },
  { "country": "DE", "activations": 87 },
  { "country": "GB", "activations": 61 }
]

Country codes are two-letter ISO 3166-1 alpha-2, sourced from Cloudflare’s CF-IPCountry header.