---
title: "List activity events (new implementation)"
method: GET
path: "/v4/activity/"
tags: ["Activity"]
---

# List activity events (new implementation)

`GET /v4/activity/`

## Request

- Base URL: `https://api.kadoa.com`
- URL: `https://api.kadoa.com/v4/activity/`
- Auth: API key in header `x-api-key`

Retrieve activity events from audit_logs table with basic filtering and pagination.

## Query parameters

- `limit` integer
- `offset` integer, nullable
- `workflowId` string
- `userId` string
- `startDate` string, date-time, nullable
- `endDate` string, date-time, nullable
- `relativeTime` string
- `eventTypes` string
- `interfaces` string
- `resourceTypes` string

## Response `200`

200

- ActivityListResponse: Successful response containing activity events and pagination
  - `error` false, required
  - `data` object, required
    - `events` ActivityEvent[], required
      - `title` string, required: Event title/type
      - `dateTime` string, date-time, required: ISO 8601 timestamp of the event
      - `source` ActivityEventSource: Source information for an activity event
        - `requestSource` string: Request source that triggered the event (SYSTEM, UI, SDK, API)
        - `userId` string: User ID who triggered the event
        - `userEmail` string: User email who triggered the event
      - `resource` ActivityEventResource: Resource information for an activity event
        - `type` string, required: Resource type (RUN, WORKFLOW, NOTIFICATION, etc.)
        - `workflowId` string: Associated workflow ID
        - `resourceId` string: Resource identifier
        - `name` string: Resource name
      - `details` ActivityEventDetails: Additional details about the activity event (varies by event type)
    - `pagination` ActivityPaginationMeta, required: Pagination metadata for activity events
      - `total` integer, required: Total number of events
      - `limit` integer, required: Number of events per page
      - `offset` integer, required: Offset for pagination
      - `hasMore` boolean, required: Whether there are more events available

## Other responses

- `401`: 401
- `403`: 403
- `500`: 500

---

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