---
title: "List agent executions"
method: GET
path: "/v1/senders/{senderId}/agent/executions"
tags: ["Agents"]
---

# List agent executions

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

List recent agent executions with pagination.

An execution is one inbound message answered by the agent, so this covers the messaging channels only. Voice calls are never listed here regardless of how many the agent handled. Use `GET /v1/calls` (and `GET /v1/calls/{callId}` for the transcript) for voice.

## Path parameters

- `senderId` string, required

## Query parameters

- `status` 'success' | 'error' | 'filtered' | 'rate_limited' | 'balance_insufficient' — Status of an agent execution.
- `limit` integer
- `cursor` string

## Response `200`

List of executions.

- object
  - `items` AgentExecution[], required
    - `id` string, required
    - `agentId` string, required
    - `inboundMessageId` string
    - `responseMessageId` string, nullable
    - `responseText` string, nullable
    - `status` 'success' | 'error' | 'filtered' | 'rate_limited' | 'balance_insufficient', required — Status of an agent execution.
    - `errorMessage` string, nullable
    - `inputTokens` integer, required
    - `outputTokens` integer, required
    - `latencyMs` integer, required
    - `cost` number, required — Cost in USD.
    - `createdAt` string, date-time, required
    - `knowledgeChunksUsed` integer, nullable — Knowledge-base chunks retrieved for this answer. Zero on an agent that has documents attached means the reply was not grounded in them, which is otherwise indistinguishable from a correct answer in this record. Absent on executions recorded before this field existed, which is not the same as zero.
    - `toolCalls` integer, nullable — Tools the agent called while producing this reply. Zero on an agent that has tools configured means it answered without calling any — the case where a reply says it will look something up and nothing ever reaches your endpoint. Absent on executions recorded before this field existed, which is not the same as zero.
  - `nextCursor` string, nullable

## Other responses

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

---

[API](https://skmtc.net/zavudev/apis/zavu-unified-messaging-layer-api.md) · [All operations](https://skmtc.net/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zavudev/zavu-unified-messaging-layer-api/revisions/4dacdff2adf8/schema)