---
title: "List recent tool calls"
method: GET
path: "/v1/tools/calls"
tags: ["Agents"]
---

# List recent tool calls

`GET /v1/tools/calls`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/tools/calls`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Audit log of recent tool invocations across the org's agents, tool name, execution mode, outcome, error and latency. No arguments or results are stored. Requires the `omni:session` scope.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string

## Response `200`

Tool calls

- ToolCallList
  - `object` string
  - `data` ToolCall[]
    - `id` string
    - `agent_id` string, nullable
    - `tool_name` string
    - `execution` 'hosted' | 'server' | 'client', nullable
    - `ok` boolean
    - `error` string, nullable
    - `latency_ms` integer, nullable
    - `call_id` string, nullable
    - `ts` integer: Unix epoch milliseconds.
  - `has_more` boolean
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `400`: Invalid request (bad field, unsupported value)
- `401`: Missing or invalid API key (`code: unauthorized`)

---

[API](https://skmtc.dev/pyai/apis/pyai-api.md) · [All operations](https://skmtc.dev/pyai/apis/pyai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pyai/apis/pyai-api/revisions/271a1539185b?raw)