---
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`

## Request

- Base URL: `https://api.lofty.com`
- URL: `https://api.lofty.com/v2.0/leads/{leadId}/activities`
- Auth: none required
- TypeScript: <https://skmtc.dev/lofty/apis/lofty-service-open-apis/docs/v2.0/leads/:leadId/activities/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/lofty/apis/lofty-service-open-apis.md) - [All operations](https://skmtc.dev/lofty/apis/lofty-service-open-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/lofty/apis/lofty-service-open-apis/revisions/23e640467118?raw)