Analytics API
Understand the purpose and administration boundary of the Codex Analytics API
The Analytics APIs provide aggregated usage and activity metrics for a ChatGPT workspace. The unified Daily Usage Analytics API reports daily ChatGPT, Codex, and Work usage. Confirm that the endpoint is enabled for your workspace before using it.
The Admin API reference is the source of truth for current access requirements, routes, request and response schemas, metrics, time semantics, and pagination.
When to use the Analytics API
The Analytics API is appropriate when you need to:
- Automate recurring workspace usage reporting.
- Join aggregated usage metrics with internal organizational data.
- Build a controlled reporting layer for approved audiences.
- Avoid coupling an integration to an interactive dashboard.
It's not a raw audit-log interface. Use the Compliance API when the workflow requires auditable activity records.
Confirm the administration boundaries
Analytics API results are scoped to a ChatGPT workspace. For the unified Daily
Usage Analytics API, use a workspace-scoped Admin key with
enterprise.analytics.usage.read. The Codex scope
codex.enterprise.analytics.read doesn't grant access to that endpoint.
The API reference owns current key provisioning, scope requirements, routes, schemas, fields, time semantics, and pagination behavior. This page doesn't duplicate that contract.