Read a deal timeline

Returns the logged activities and the changes to the deal (created, moved between stages, value, name or close date changed, lost reason set) in one list, newest first. Each entry names who made it in actor_name.

GEThttps://app.softsolz.uk/api/v1/services/pipelines/pipelines/deals/{deal_id}/timeline

Recent Requests

Kept only in this browser

TimeStatusTook

Send a request with Try it to see it here.

Path Params

deal_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Query Params

limitinteger

Page size, 1-200 (default 50).

offsetinteger

Number of entries to skip (default 0).

Response

Response Body · array of objects

subjectstring | nullShort subject line. Activities only.

bodystring | nullActivity details. Activities only.

sourcestring | nullWhere the activity came from, when it was logged by another tool. Activities only.

source_idstring | nullReference of the record in that other tool. Activities only.

due_atstring | nullWhen a follow-up is due, or null. Activities only.

completed_atstring | nullWhen the activity was marked done, or null. Activities only.

idstringEntry id, prefixed "activity-" or "event-".

activity_idstringActivity id. Activity entries only.

entry_typestringWhether this is a logged activity or a change to the deal.

kindstringFor activities: note, call, email, meeting, task, message, quote or system. For events: created, stage_changed, value_changed, title_changed, close_date_changed or lost_reason_set.

from_stagestring | nullStage the deal left. Events only.

to_stagestring | nullStage the deal entered. Events only.

detailobjectExtra facts about the event, such as the stage names, or the old and new value in minor units with its currency. Events only.

duration_secondsinteger | nullHow long the deal sat in the stage it left, in seconds. Events only.

actor_namestring | nullWho made the change: the member name, or the name of the API key or connected app that made it. Null when unknown.

created_atstringWhen it happened.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/pipelines/pipelines/deals/{deal_id}/timeline \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

Authorization

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": [
    {
      "subject": "Intro call",
      "body": "Wants pricing by Friday.",
      "source": null,
      "source_id": null,
      "due_at": "2026-10-09T10:00:00.000Z",
      "completed_at": null,
      "id": "event-41",
      "activity_id": "88",
      "entry_type": "event",
      "kind": "stage_changed",
      "from_stage": "New",
      "to_stage": "Qualified",
      "detail": {
        "from": "New",
        "to": "Qualified"
      },
      "duration_seconds": 86400,
      "actor_name": "Sam Patel",
      "created_at": "2026-10-02T11:00:00.000Z"
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}