Relationship Intelligence

Activity

Activity loads when a company opens. The request asks for the first 50 records and sends no older-page time. The answer lists the newest activity first, from Slack, Calendar, Gmail, and HubSpot.

get/v1/relationships/{relationshipId}/timeline

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/relationships/{relationshipId}/timeline
Auth: HTTP bearer

Path parameters

relationshipIdstring uuid required

Example:9c8dfa9b-a7b2-46ea-982c-622a914c00e5

Company id.

Query parameters

limitinteger

Example:50

How many records to return. Opening a company asks for 50.

beforestring date-time

Return records before this time. The first page does not send it.

beforeIdstring uuid

With before, also return records at that time whose id sorts earlier. The first page does not send it.

Response

The activity this company loads.

hasMoreboolean required

An older record exists beyond this page.

nextBeforestring date-time nullable

Time of the last record on this page. Send it to load older records that share that time.

nextBeforeIdstring uuid nullable

Id of the last record on this page. Send it with the time so records that share that time stay on the next page.

Example response

{
  "nextBefore": "2026-07-08T15:00:00Z",
  "nextBeforeId": "f48dfa9b-a7b2-46ea-982c-622a914c00e5",
  "observations": [
    {
      "contentHash": "c649f448e463924ae2a0923fcc6d409bc5a808004027b16bfbea961336650984",
      "eventType": "commitment_created",
      "externalId": "message-123",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "normalizedFacts": {
        "adapter": "gmail"
      },
      "occurredAt": "2026-07-18T17:30:00Z",
      "receivedAt": "2026-07-18T17:31:00Z",
      "source": "gmail",
      "sourceAccountId": "me@company.com",
      "sourceVersion": "1",
      "summary": "We promised to send the security packet."
    }
  ]
}

Changes

No recorded changes to this operation across all 50 revisions of this API.