---
title: "Search and retrieve tool execution logs"
method: POST
path: "/api/v3.1/logs/tool_execution"
tags: ["Logs"]
---

# Search and retrieve tool execution logs

`POST /api/v3.1/logs/tool_execution`

Search and retrieve tool execution logs with filtering, pagination, and time range support.

## Request body

- object
  - `limit` number
  - `cursor` string, nullable
  - `filters` object[]
    - `field` 'tool_slug' | 'toolkit_slug' | 'connected_account_id' | 'auth_config_id' | 'status' | 'user_id' | 'session_id' | 'sandbox_id' | 'request_id' | 'log_id', required
    - `operator` '==' | '!=' | 'contains' | 'not_contains', required
    - `value` string, required
  - `time_range` object
    - `from` number, required — Start time in epoch milliseconds
    - `to` number, required — End time in epoch milliseconds

## Response `200`

Successfully retrieved tool logs

- object
  - `logs` object[], required
    - `id` string, required
    - `timestamp` string, date-time, required — ISO 8601 timestamp
    - `type` string, required — Log event type, e.g. tool.execution, trigger.message, connected_account.created
    - `status` 'success' | 'failed', required
    - `level` 'info' | 'error' | 'warn', required
    - `message` string
    - `metadata` object, required
    - `metrics` object, required
    - `parent` object, nullable, required
      - `log_id` string, required
      - `tool_slug` string, required
  - `next_cursor` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)