---
title: "Usage breakdown by endpoint"
method: GET
path: "/v1/usage/analytics"
tags: ["Account"]
---

# Usage breakdown by endpoint

`GET /v1/usage/analytics`

## Request

- Base URL: `https://api.puntersedge.online`
- URL: `https://api.puntersedge.online/v1/usage/analytics`
- Auth: API key in header `X-API-Key`

Cost: 0 credits. Credit usage grouped by endpoint.

`period=billing` exists because the rolling window never lines up with what you are
actually billed on: the credit counter is zeroed at 00:00 UTC on the 1st of each month,
so on the 18th a 30-day rolling total spans two allowances
and cannot be reconciled against credits_used. The default stays `rolling` so no existing
client changes behaviour.

⚠️ `period_days` is an int under `period=rolling` (it echoes `days`, unchanged) and a
float under `period=billing`, where it is the measured length of the current period
rather than a requested window — e.g. 31.0 for a period that started on the 1st. The
widening only reaches callers who opt in by passing the new parameter; `period_start` and
`period_end` are always returned so the window never has to be inferred from it.

## Query parameters

- `days` integer: Rolling window length. Ignored when period=billing.
- `period` string: rolling = the last `days` days (default, unchanged). billing = the CURRENT billing period, so the totals here match credits_used and credits_remaining exactly.

## Headers

- `X-API-Key` string
- `X-RapidAPI-Proxy-Secret` string

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Missing or invalid API key. Send `X-API-Key`. See https://puntersedge.online/developers/errors
- `402`: Monthly credit allowance exhausted for this plan. Upgrade at https://puntersedge.online/api/pricing
- `422`: Validation Error
- `429`: Rate limit exceeded for this plan. Honour the `Retry-After` header (seconds) before retrying. See https://puntersedge.online/developers/rate-limits
- `500`: Unexpected server error. Safe to retry with backoff.

---

[API](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api.md) · [All operations](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/revisions/f35b6aab1946?raw)