Sign in

v1

latestOpenAPI 3.0.12026-07-22120163333.7 KB
Lead System Logs

System Logs

Returns system-event timeline entries for the lead, sorted by timelineTime descending (newest first), with offset-based pagination.

Only system / change-log activity events are returned (e.g. stage changes, assignment/routing, subscriptions, smart-plan tasks). Call, text, email and site-activity (search / view / favorite) entries are NOT included, nor is note content (e.g. adding a note); edit/delete-note actions (types 17/18) are included. Each entry includes both the timelineType integer and a human-readable timelineTypeDesc name, so you do not need to map the integer yourself.

Note: startTime/endTime query parameters are epoch milliseconds, but the timelineTime/createTime/updateTime fields in the response are ISO-8601 strings.

Authorization: the authenticated user must be the lead's owner or the shared agent; otherwise 403 is returned.

get/v1.0/systemLogs

Query parameters

leadIdinteger required

ID of the lead.

startTimeinteger

Inclusive lower bound (milliseconds since Unix epoch, UTC).

endTimeinteger

Inclusive upper bound (milliseconds since Unix epoch, UTC).

pageNumberinteger

0-based page index.

pageSizeinteger

Number of entries per page.

Headers

Authorizationstring required

Bearer [access_token]

Response

System log page retrieved successfully.

hasMore0 | 1

Whether more pages exist after the current one. 1 = more entries, 0 = last page.

Example response

{
  "hasMore": 1,
  "timeLines": [
    {
      "id": "1224565260755697664",
      "leadId": 1125957935106829,
      "agentId": 302656410082719,
      "timelineType": 38,
      "timelineTypeDesc": "TeamStageChange",
      "timelineTime": "2026-06-10T05:51:02.165+00:00",
      "createTime": "2026-06-10T05:51:59.727+00:00",
      "updateTime": "2026-06-10T05:51:59.727+00:00",
      "fromId": 302656410082719,
      "fromType": 1,
      "toId": 1125957935106829,
      "toType": 2,
      "fromFirstName": "Jane",
      "fromLastName": "Doe",
      "toFirstName": "Sarah",
      "toLastName": "Johnson",
      "refId": 2033115,
      "content": {
        "fromStageName": "New",
        "toStageName": "Active"
      }
    }
  ]
}