---
title: "Get agent statistics"
method: GET
path: "/v1/senders/{senderId}/agent/stats"
tags: ["Agents"]
---

# Get agent statistics

`GET /v1/senders/{senderId}/agent/stats`

## Request

- Base URL: `https://api.zavu.dev`
- URL: `https://api.zavu.dev/v1/senders/{senderId}/agent/stats`
- Auth: HTTP bearer

Get statistics for an AI agent including invocations, tokens, and costs.

Covers the messaging channels only. Voice calls are not counted here: a call is a multi-turn conversation rather than one inbound message and one reply, so it is recorded as a call, not an execution. An agent that only answers phone calls reports zeros on every field. Use `GET /v1/calls` for voice activity, duration, and cost.

## Path parameters

- `senderId` string, required

## Response `200`

Agent statistics.

- AgentStats
  - `totalInvocations` integer, required
  - `totalTokensUsed` integer, required
  - `totalCost` number, required: Total cost in USD.
  - `successCount` integer, required: Successful executions among the agent's 100 most recent. Executions with status `filtered` (messages the agent never ran on) are not counted here, in `errorCount` or in `avgLatencyMs`.
  - `errorCount` integer, required: Failed executions among the agent's 100 most recent.
  - `avgLatencyMs` number, nullable: Average latency of the agent's 100 most recent executions, `filtered` excluded. Null when there are none.

## Other responses

- `401`: Unauthorized.
- `404`: Agent not found.

---

[API](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api.md) - [All operations](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/revisions/75bc777b0ffb?raw)