---
title: "Get Entity Timeline"
method: GET
path: "/v1/entities/{entity_id}/timeline"
tags: ["entities", "product-api", "product-api"]
---

# Get Entity Timeline

`GET /v1/entities/{entity_id}/timeline`

## Request

- Base URL: `https://api.myarchivist.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myarchivist.ai/v1/entities/{entity_id}/timeline`
- Auth: HTTP bearer

Sessions whose step beats wikilink to this compendium entity.

Product-view only. Assembled in one shot from the Link table — not a
paginated listing of every campaign beat.

## Path parameters

- `entity_id` string, required

## Query parameters

- `campaign_id` string, required
- `type` 'characters' | 'factions' | 'locations' | 'items', required: Entity type

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- EntityTimelineResponse
  - `sessions` EntityTimelineSessionRead[]
    - `id` string, required
    - `title` string, required
    - `session_date` string, date-time, nullable
    - `session_number` integer, required
    - `steps` EntityTimelineStepRead[]
      - `id` string, required
      - `label` string, required
      - `description` string
      - `index` integer
      - `characters` string[]
      - `factions` string[]
      - `locations` string[]
      - `items` string[]
      - `minor_beat` EntityTimelineBeatParent
        - `id` string, required
        - `label` string, required
        - `index` integer
      - `major_beat` EntityTimelineBeatParent
        - `id` string, required
        - `label` string, required
        - `index` integer
  - `total_sessions` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/myarchivist/apis/archivist-public-api.md) · [All operations](https://skmtc.dev/myarchivist/apis/archivist-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/myarchivist/apis/archivist-public-api/revisions/3ea6ca7efc56?raw)