---
title: "Get Inference Usage Summary Rollup"
method: GET
path: "/api/v1/edges/inference/usage"
tags: ["Edge"]
---

# Get Inference Usage Summary Rollup

`GET /api/v1/edges/inference/usage`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/edges/inference/usage`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Returns inference request and token totals across the Edges the caller manages, with time series and model breakdowns.

## Query parameters

- `bucket` 'TB_TIME_BUCKET_UNSPECIFIED' | 'TB_TIME_BUCKET_HOUR' | 'TB_TIME_BUCKET_DAY': The bucket field.
- `since` string, int64: The since field.
- `until` string, int64: The until field.

## Response `200`

Successful response

- C1ApiEdgeV1EdgeServiceGetInferenceUsageSummaryRollupResponse: The EdgeServiceGetInferenceUsageSummaryRollupResponse message.
  - `authRejectedCount` string, uint64: See TBUsageSummary.auth_rejected_count and auth_rejected_total.
  - `authRejectedTotal` string, uint64: The authRejectedTotal field.
  - `edgeCount` integer: Number of authorized Edges included. Zero means the caller manages no Edges, as distinct from Edges that have no traffic yet.
  - `modelBreakdown` C1ApiEdgeV1TBUsageModelBreakdown[], nullable: The modelBreakdown field.
    - `inputTokens` string, uint64: The inputTokens field.
    - `logicalModel` string: The logicalModel field.
    - `modelTarget` string: The modelTarget field.
    - `outputTokens` string, uint64: The outputTokens field.
    - `requestCount` string, uint64: The requestCount field.
  - `series` C1ApiEdgeV1TBUsageSummaryBucket[], nullable: The series field.
    - `bucketStart` string, date-time, nullable
    - `inputTokens` string, uint64: The inputTokens field.
    - `outputTokens` string, uint64: The outputTokens field.
  - `totalCacheReadTokens` string, uint64: The totalCacheReadTokens field.
  - `totalCacheWriteTokens` string, uint64: The totalCacheWriteTokens field.
  - `totalInputTokens` string, uint64: The totalInputTokens field.
  - `totalOutputTokens` string, uint64: The totalOutputTokens field.
  - `totalRequests` string, uint64: The totalRequests field.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/edges/inference/usage/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)