---
title: "Admin \u2014 usage"
path: reference/api/admin-usage
status: published
---

# Admin — usage

**2 endpoints** in this group. All paths are prefixed with `/api/v1`.

## Endpoints in this group

- [`GET /api/v1/admin/usage/aggregate`](#get-api-v1-admin-usage-aggregate) — Admin Aggregate Usage
- [`GET /api/v1/admin/usage/tenant/{tenant_id}`](#get-api-v1-admin-usage-tenant-tenant-id) — Admin Tenant Usage

---

### GET `/api/v1/admin/usage/aggregate` — Admin Aggregate Usage {#get-api-v1-admin-usage-aggregate}

Platform-wide aggregate usage statistics.

Returns total usage per service/metric across all tenants, plus
the count of distinct active tenants per service.

**Parameters**:

- `period_type` (query, string, optional)
- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `ApiResponse_dict_` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}


### GET `/api/v1/admin/usage/tenant/{tenant_id}` — Admin Tenant Usage {#get-api-v1-admin-usage-tenant-tenant-id}

Admin view of a specific tenant's usage for the current period.

**Parameters**:

- `tenant_id` (path, string, required)
- `period_type` (query, string, optional)
- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `ApiResponse_UsageSummaryResponse_` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}