---
title: "Get Tool Executions"
method: GET
path: "/v1/convai/tools/{tool_id}/executions"
tags: ["Agents Platform"]
---

# Get Tool Executions

`GET /v1/convai/tools/{tool_id}/executions`

Get paginated list of tool executions for a specific tool.

## Path parameters

- `tool_id` string, required — ID of the requested tool.

## Query parameters

- `cursor` string, nullable — Used for fetching next page. Cursor is returned in the response.
- `page_size` integer — How many documents to return at maximum. Can not exceed 100, defaults to 30.
- `is_error` boolean, nullable — Filter by error status. If not provided, returns all executions.
- `agent_id` string, nullable — Filter by agent ID.
- `branch_id` string, nullable — Filter by agent branch ID.
- `start_time` number, nullable — Filter executions from this Unix timestamp (inclusive).
- `end_time` number, nullable — Filter executions until this Unix timestamp (inclusive).

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetToolExecutionsPageResponseModel
  - `executions` ToolExecutionResponseModel[], required
    - `tool_id` string, required — The ID of the tool that was executed
    - `tool_request_id` string, required — The request/call ID associated with this tool execution
    - `conversation_id` string, required — The ID of the conversation where the tool was executed
    - `agent_id` string, required — The ID of the agent that ran the tool
    - `branch_id` string, nullable — The branch ID if the agent has branches
    - `timestamp` number, required — Unix timestamp when the tool was executed
    - `latency_secs` number, required — How long the tool execution took
    - `is_error` boolean — Whether the tool execution failed
    - `request_payload` string, nullable — LLM-extracted parameters sent to the tool (JSON string)
    - `response_payload` string, nullable — Response returned by the tool
    - `error_message` string, nullable — Error message if the tool execution failed
    - `error_type` string, nullable — Error category (internal, customer_config, customer_auth, external_server, external_client, client_timeout, unknown)
    - `id` string, required
    - `tool_call_details` union
      - ConversationHistoryTranscriptToolCallWebhookDetails
        - `type` 'webhook'
        - `method` string, required
        - `url` string, required
        - `headers` object
        - `path_params` object
        - `query_params` object
        - `body` string, nullable
      - ConversationHistoryTranscriptToolCallClientDetails
        - `type` 'client'
        - `parameters` string, required
      - ConversationHistoryTranscriptToolCallMCPDetails
        - `type` 'mcp'
        - `mcp_server_id` string, required
        - `mcp_server_name` string, required
        - `integration_type` string, required
        - `parameters` object
        - `approval_policy` string, required
        - `requires_approval` boolean
        - `mcp_tool_name` string
        - `mcp_tool_description` string
      - ConversationHistoryTranscriptToolCallApiIntegrationWebhookDetailsOutput
        - `type` 'api_integration_webhook', required
        - `integration_id` string, required
        - `credential_id` string, required
        - `integration_connection_id` string, required
        - `webhook_details` ConversationHistoryTranscriptToolCallWebhookDetails, required
          - `type` 'webhook'
          - `method` string, required
          - `url` string, required
          - `headers` object
          - `path_params` object
          - `query_params` object
          - `body` string, nullable
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/e77a0a530a82/schema)