List manual logs of a lead
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.
Headers
Bearer [access_token]
Query Parameters
ID of the lead whose manual logs to return.
x >= 1Channel filter. Case-sensitive.
logCall, logEmail, logText Zero-based index of the first entry to return. Values < 0 are silently reset to 0. Ignored when currentId > 0.
x >= 0Number of entries to return per page. Values outside [1, 1000] are silently reset to 10. offset + limit must not exceed 20000.
1 <= x <= 1000This parameter is used for page turning. When searching by ID is invoked, the interface would starts from this ID, and retrieve data sequentially. It is recommended to use this parameter as a replacement for offset to turn the page within the limit.
Sort field. 'createTime' orders by the entry's logged time; 'id' orders by the entry's ID. Ignored in cursor mode.
createTime, id Sort direction. 'asc' returns oldest first; 'desc' returns newest first.
asc, desc Response
Page of manual log entries for the requested channel.
Wrapped response for GET /v1.0/logType. The manual log entries are returned under the 'logType' key.
Manual log entries on this page, ordered by the request's sort and order parameters.