---
title: "List lead activities"
method: GET
path: "/v2.0/leads/{leadId}/activities"
tags: ["Lead Activity V2 API"]
---

# List lead activities

`GET /v2.0/leads/{leadId}/activities`

Returns a unified list of call, text and email activities for the given lead, including both auto-captured and agent-logged entries, sorted by activityTime ascending.

Notes:
- Caller must have access to the lead; otherwise 404 LEAD_NOT_EXIST.
- Use currentId for cursor-based pagination or offset for offset-based pagination.

## Path parameters

- `leadId` integer, required

## Query parameters

- `currentId` integer — Cursor-based pagination anchor. Pass the last returned item's id to fetch the next page. Default 0 (start from beginning).
- `offset` integer — Offset for offset-based pagination. Ignored when currentId > 0. Default 0.
- `limit` integer — Page size, 1–1000. Default 10.
- `timeZoneCode` string, nullable — Timezone in IANA format (e.g. America/Los_Angeles). Affects activityTime formatting. Defaults to user configured timezone if not provided.

## Headers

- `Authorization` string, required

## Response `200`

Unified activity entries for the lead.

- ActivityListResponse — Wrapped response for GET /v2.0/leads/{leadId}/activities. Activity entries are returned under the 'activities' key.
  - `activities` ActivityItem[] — Unified call, text and email activities for the lead, sorted by activityTime ascending.
    - `id` integer — Timeline ID
    - `leadId` integer — Lead ID
    - `agentId` integer — Agent ID
    - `activityTime` string — Activity time (ISO 8601)
    - `channel` string — Communication channel: Call / Text / Email
    - `communicationType` string — Communication type: Auto / Manual / Logged
    - `direction` string — Direction: Inbound / Outbound
    - `callingOutcome` string — Call outcome, e.g. Talked / No Answer (Call only)
    - `leadPhoneNumber` string — Lead phone number (Call only)
    - `emailEventType` string — Email event type: Sent / Opened / Bounced (Email only)
    - `emailSubject` string — Email subject (Email only)
    - `note` string — Note content from agent manual log (Logged only)

## Other responses

- `401` — Missing or invalid authentication token.
- `404` — Lead does not exist or is not accessible to the caller (20006 LEAD_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)