---
title: "Search and retrieve trigger event logs"
method: POST
path: "/api/v3.1/internal/trigger/logs"
tags: ["Logs", "x-internal"]
---

# Search and retrieve trigger event logs

`POST /api/v3.1/internal/trigger/logs`

Search and retrieve trigger event logs with advanced filtering capabilities including search parameters

## Request body

- object
  - `time` '5m' | '30m' | '6h' | '1d' | '1w' | '1month' | '1y' — Return logs from the last N time units
  - `from` number, nullable — Start time for logs (epoch timestamp in milliseconds)
  - `to` number, nullable — End time for logs (epoch timestamp in milliseconds)
  - `status` 'all' | 'success' | 'error' — Filter logs by their status level
  - `search` string — Search term to filter logs
  - `integrationId` string, uuid
  - `entityId` string
  - `userId` string — Filter logs by user ID
  - `limit` number, nullable — The limit of trigger logs to return
  - `cursor` string, nullable
  - `search_params` object[] — Advanced search parameters for filtering logs
    - `field` string
    - `operation` string
    - `value` string
  - `include_payload` boolean — Whether to include payload fields in the response. Set to false for faster list views.

## Response `200`

Successfully retrieved trigger logs

- object
  - `nextCursor` string, nullable, required
  - `data` object[]
    - `id` string, required
    - `connectionId` string, required
    - `clientId` string, required
    - `entityId` string, required
    - `status` string, required
    - `appName` string, required
    - `createdAt` string, required
    - `type` 'trigger' | 'action', required — Log entity type (trigger or action)
    - `meta` object, required
      - `id` string, required
      - `type` 'trigger' | 'action', required — Log entity type (trigger or action)
      - `createdAt` string, required
      - `updatedAt` string, required
      - `provider` string, required
      - `clientId` string, required
      - `connectionId` string, required
      - `triggerProviderPayload` string
      - `triggerClientPayload` string
      - `triggerClientError` string
      - `triggerName` string
      - `triggerClientResponse` string
      - `triggerId` string
      - `triggerNanoId` string

## 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)