---
title: "Api Usage Analytics"
method: GET
path: "/api/analytics/usage"
tags: ["Billing"]
---

# Api Usage Analytics

`GET /api/analytics/usage`

Usage analytics for both providers and submitters.

Provides cost breakdowns, GPU utilization trends, and hardware health
aggregates over time. Supports grouping by day, week, GPU model,
or province for detailed reporting.

Query params:
- `customer_id` — filter to one customer (submitter view)
- `provider_id` — filter to one provider (earnings view)
- `days` — lookback window (default 30)
- `group_by` — aggregation: `day`, `week`, `gpu_model`, `province`

## Query parameters

- `customer_id` string
- `provider_id` string
- `days` integer
- `group_by` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/aabiro/apis/xcelsior.md) · [All operations](https://skmtc.dev/aabiro/apis/xcelsior/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aabiro/xcelsior/revisions/526c3dd3d9d7/schema)