Skip to main content
This guide shows you how to retrieve usage metrics for an agent using the v2 Agentic API. You will learn about granularity, date ranges, and how to interpret the response.

Prerequisites

  • An existing agent with at least one invocation
  • An access token or client credentials

Get usage

Query parameters

Response structure

The response contains range-wide totals and an array of buckets:

Interpreting metrics

For per-task token and credit accounting, see the $usage field in the task metadata.

Next steps