---
title: "List events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# List events

`GET /v1/events`

List execution events with optional filters.

Supports filtering by:
- `customerId`: Events for a specific customer
- `runId`: Events in a specific agent run
- `workflowId`: Events in a specific workflow
- `eventType`: Filter by event type (e.g., LLM_INFERENCE)
- `outcome`: Filter by outcome (e.g., SUCCESS, FAILURE)
- `actionName`: Filter by action name
- `parentEventId`: Get child events
- `idempotencyKey`: Exact match on idempotency key
- Time range: `from` and `to` (ISO 8601)

## Query parameters

- `customerId` string
- `runId` string
- `workflowId` string
- `eventType` 'USAGE' | 'API_CALL' | 'LLM_INFERENCE' | 'TOOL_CALL' | 'DATABASE' | 'FILE_IO' | 'NETWORK' | 'DECISION' | 'HUMAN_IN_LOOP' | 'MEMORY' | 'CUSTOM' | 'TOOL_CALL_START' | 'TOOL_CALL_END' | 'TOOL_CALL_ERROR' | 'TOOL_CALL_RETRY' | 'TRAINING' | 'FINE_TUNING'
- `outcome` 'PENDING' | 'SUCCEEDED' | 'FAILED' | 'SKIPPED' | 'RETRIED' | 'TIMEOUT' | 'CANCELLED'
- `actionName` string
- `parentEventId` string
- `idempotencyKey` string
- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

List of events with pagination

- object — List of events with pagination
  - `data` object[]
    - `id` string
    - `eventType` string
    - `actionName` string
    - `outcome` string
    - `explanation` string, nullable
    - `idempotencyKey` string, nullable — Client-provided idempotency key
    - `customerId` string
    - `runId` string, nullable
    - `workflowId` string, nullable
    - `parentEventId` string, nullable
    - `retryOfEventId` string, nullable
    - `attemptNumber` integer
    - `createdAt` string, date-time
    - `chargeId` string, nullable
    - `costUsdc` string, nullable
    - `usageType` string, nullable
    - `quantity` string, nullable
    - `units` string, nullable
    - `description` string, nullable
    - `metadata` object, nullable
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `offset` integer
    - `hasMore` boolean

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/revisions/2cb1567969ca/schema)