curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/records/{id}/timeline \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/records/{id}/timeline', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/records/{id}/timeline"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Timeline events fetched successfully",
"pagination": {
"total": 2,
"page": 1,
"limit": 20,
"hasMore": false
}
},
"data": {
"summary": "Northwind Traders is evaluating the Growth plan. Procurement asked for a security review before signing.",
"events": [
{
"_id": "6728c0a1b2c3d4e5f6a7b8c9",
"timestamp": "2026-11-04T06:00:00.000Z",
"metadata": {
"objectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaId": "66a0f1e2d3c4b5a697880001",
"relationshipObjectType": "company",
"summary": "Ana Silva confirmed budget for Q1 on a pricing call and asked for the security questionnaire by Friday."
}
},
{
"_id": "6727a3f0b2c3d4e5f6a7b8c1",
"timestamp": "2026-11-03T06:00:00.000Z",
"metadata": {
"objectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaId": "66a0f1e2d3c4b5a697880001",
"relationshipObjectType": "company",
"summary": "Sent the proposal to the buying committee. No reply yet."
}
}
]
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}List timeline entries
Returns the AI-written timeline of a company, person or deal, newest first, together with the record’s current relationship summary.
Entries are written on a schedule, not on every change. A record with no recent activity can
have no entries. For the exact change history use List record events, and for the emails and meetings themselves use List interactions with filters.objectId.
This list pages by page number only: send page and limit. meta.pagination holds total,
page, limit and hasMore. The relationship summary is also repeated in meta.summary.
curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/records/{id}/timeline \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/records/{id}/timeline', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/records/{id}/timeline"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Timeline events fetched successfully",
"pagination": {
"total": 2,
"page": 1,
"limit": 20,
"hasMore": false
}
},
"data": {
"summary": "Northwind Traders is evaluating the Growth plan. Procurement asked for a security review before signing.",
"events": [
{
"_id": "6728c0a1b2c3d4e5f6a7b8c9",
"timestamp": "2026-11-04T06:00:00.000Z",
"metadata": {
"objectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaId": "66a0f1e2d3c4b5a697880001",
"relationshipObjectType": "company",
"summary": "Ana Silva confirmed budget for Q1 on a pricing call and asked for the security questionnaire by Friday."
}
},
{
"_id": "6727a3f0b2c3d4e5f6a7b8c1",
"timestamp": "2026-11-03T06:00:00.000Z",
"metadata": {
"objectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaId": "66a0f1e2d3c4b5a697880001",
"relationshipObjectType": "company",
"summary": "Sent the proposal to the buying committee. No reply yet."
}
}
]
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}heliyos_records_timeline.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Path Parameters
The record's id (a company, person or deal).
^[0-9a-fA-F]{24}$Query Parameters
Entries per page, 1 to 100. Defaults to 20.
1 <= x <= 100The page number, starting at 1. Defaults to 1.
x >= 1Was this page helpful?

