Relationship Intelligence

Mail and meetings

Mail and meetings loads when a company opens. The request asks for the first 50 records and sends no older-page time. The answer is the newest record, the sent message Follow up, and shows this mailbox can see it.

get/v1/relationships/{relationshipId}/communication-timeline

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/relationships/{relationshipId}/communication-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 mail and meetings this company loads.

hasMoreboolean required

More pages exist.

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

{
  "items": [
    {
      "access": {
        "attachments": true,
        "body": true,
        "metadata": true,
        "policyVersion": 1,
        "reason": "mailbox_owner",
        "subject": true
      },
      "attachmentCount": 1,
      "direction": "outbound",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "interactionType": "email",
      "occurredAt": "2026-09-17T12:00:00Z",
      "ownerId": "7b8dfa9b-a7b2-46ea-982c-622a914c00e5",
      "source": "gmail",
      "subject": "Follow up",
      "visibility": "metadata"
    }
  ],
  "nextBefore": "2026-09-17T12:00:00Z",
  "nextBeforeId": "e18dfa9b-a7b2-46ea-982c-622a914c00e5"
}

Changes

No operation changes recorded.