---
title: "Get record timeline"
method: GET
path: "/v1/records/{record_id}/timeline"
tags: ["Timeline"]
---

# Get record timeline

`GET /v1/records/{record_id}/timeline`

## Request

- Base URL: `https://app.nex.ai/api/developers`
- URL: `https://app.nex.ai/api/developers/v1/records/{record_id}/timeline`
- Auth: API key in header `Authorization`

Retrieves the activity timeline for a specific record, including tasks, notes, attribute changes, and relationship events. Supports cursor-based pagination.

## Path parameters

- `record_id` integer, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Timeline events

- DeveloperTimelineResponse
  - `data` DeveloperTimelineEventResponse[]
    - `id` string
    - `resource_type` 'entity' | 'task' | 'note' | 'list_item' | 'attribute': Type of resource
    - `resource_id` string
    - `event_type` 'created' | 'updated' | 'deleted' | 'archived': Type of event
    - `event_payload` DeveloperTimelineEventPayloadResponse: Only the relevant field is populated based on resource_type
      - `task` DeveloperTimelineTaskPayload
        - `id` string
        - `title` string
        - `due_date` string, date-time
        - `priority` string
        - `completed_at` string, date-time
      - `note` DeveloperTimelineNotePayload
        - `id` string
        - `title` string
        - `content` string
      - `entity` DeveloperTimelineEntityPayload
        - `id` string
        - `definition_id` string
        - `type` string
        - `name` string
        - `attributes` object
      - `list_item` DeveloperTimelineListItemPayload
        - `id` string
        - `definition_id` string
        - `list_name` string
        - `parent_id` string
      - `attribute` DeveloperTimelineAttributePayload
        - `id` string
        - `definition_id` string
        - `slug` string
        - `type` string
        - `value` unknown
        - `plain_text` string
      - `field_changes` DeveloperFieldChangeResponse[]
        - `field_name` string
        - `old_value` unknown
        - `new_value` unknown
    - `event_timestamp` string, date-time
    - `created_by` string
    - `created_by_id` string
    - `is_aggregated` boolean
    - `children` DeveloperTimelineEventResponse[]
  - `has_next_page` boolean
  - `next_cursor` string

## Other responses

- `400`: Bad request - Invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `404`: Record not found
- `500`: Internal server error

## Changes

- **2026-02-17** `b05d8cb8cf43`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nex/apis/nex-developer-api/changes/v1/records/:record_id/timeline/get.md)

---

[API](https://skmtc.dev/nex/apis/nex-developer-api.md) - [All operations](https://skmtc.dev/nex/apis/nex-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nex/apis/nex-developer-api/revisions/51003af13108?raw)