---
title: "AI usage telemetry (admin, READ-only)"
method: GET
path: "/api/v1/admin/ai-usage"
tags: ["Admin (scope: admin)"]
---

# AI usage telemetry (admin, READ-only)

`GET /api/v1/admin/ai-usage`

## Request

- Base URL: `https://legal.nexusquantum.legal`
- URL: `https://legal.nexusquantum.legal/api/v1/admin/ai-usage`
- Auth: HTTP bearer

Aggregated platform-wide AI usage telemetry. Thin loopback to `/api/admin/ai-usage`. Scope `admin` (necessary but not sufficient: live re-check against `admin_users`). 0 credits. API-ONLY (no MCP tool).

## Response `200`

AI usage telemetry.

- object

## Other responses

- `401`: Invalid API key.
- `403`: INSUFFICIENT_SCOPE (missing `admin` scope) or account is no longer an admin.
- `429`: RATE_LIMITED

---

[API](https://skmtc.dev/nexusquantum/apis/nexus-legal-api.md) · [All operations](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/revisions/4084d8d4eb0b?raw)