---
title: "List manual logs of a lead"
method: GET
path: "/v1.0/logType"
tags: ["Lead Manual Log"]
---

# List manual logs of a lead

`GET /v1.0/logType`

Returns the lead's manual-log entries for a single channel (logCall, logEmail or logText), paginated via offset+limit or cursor (currentId).

Notes:
- Only entries whose logType equals logCall, logEmail or logText are returned. Auto-captured communications are not included.
- Caller must have access to the lead; otherwise 404 LEAD_NOT_EXIST.
- Default mode (currentId=0): offset + limit pagination, ordered by sort and order.
- Cursor mode (currentId > 0): the sort parameter is ignored; entries are ordered by id, with timelineTime as secondary key, matching the direction in order.
- limit outside [1, 1000] is silently reset to 10; offset < 0 is silently reset to 0; offset + limit > 20000 returns 400 OFFSET_EXCEED_LIMIT.
- sort=createTime (default) orders by the entry time as logged by the agent (usually equal to the record's creation time). sort=id orders by the entry's ID.
- order=asc (default) returns oldest first; pass order=desc for newest first.

## Query parameters

- `leadId` integer, required
- `logType` 'logCall' | 'logEmail' | 'logText', required
- `offset` integer
- `limit` integer
- `currentId` integer
- `sort` 'createTime' | 'id'
- `order` 'asc' | 'desc'

## Headers

- `Authorization` string, required

## Response `200`

Page of manual log entries for the requested channel.

- LogTypeListResponse — Wrapped response for GET /v1.0/logType. The manual log entries are returned under the 'logType' key.
  - `logType` LogTypeResponse[] — Manual log entries on this page, ordered by the request's sort and order parameters.
    - `id` integer — ID of the manual log entry.
    - `leadId` integer — ID of the lead this entry belongs to.
    - `leadPhoneNumber` string — Phone number associated with the call. Only populated for logCall entries.
    - `callingOutcome` 'Talked' | 'VoiceMessage' | 'NoAnswer' | 'BadNumber' | 'DNCNumber' | 'DNCContact' — Outcome of the call. Only populated for logCall entries.
    - `content` string — Body of the log entry: call notes, email body, or SMS content.
    - `createTime` string — Time the entry was logged, formatted as 'yyyy-MM-dd HH:mm:ss' in UTC.
    - `outboundOrInbound` 'outbound' | 'inbound' — Direction of the communication from the agent's point of view. 'outbound' = agent -> lead; 'inbound' = lead -> agent.
    - `isPin` boolean — Whether this entry is pinned to the top of the lead's timeline.
    - `agentId` integer — User ID of the agent who created the entry.
    - `emailSubject` string — Email subject. Only populated for logEmail entries.
    - `toEmail` string — Recipient email address. Only populated for logEmail entries.
    - `fromEmail` string — Sender email address. Only populated for logEmail entries.

## Other responses

- `400` — Invalid logType (not one of logCall/logEmail/logText — business code 20012), or offset+limit exceeds 20000 (business code 200104).
- `401` — Missing or invalid authentication token.
- `404` — Lead does not exist, is trashed, or is not accessible to the caller (business code 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-service-production.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)