---
title: "Get timeline events"
method: GET
path: "/timeline"
tags: ["timeline"]
---

# Get timeline events

`GET /timeline`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/timeline`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/timeline/get.ts> (a function with typed inputs; its response is checked against the schema)

Get timeline events

## Query parameters

- `start_date` integer
- `end_date` integer

## Response `200`

OK

- ModelsTimelineEvent[]
  - `desktop_id` string
  - `end_time` integer
  - `filename` string
  - `id` integer
  - `idle` boolean
  - `start_time` integer
  - `title` string

## Other responses

- `400`: Possible error messages: * Timeline is not enabled * Invalid 'start\_date' value * Invalid 'end\_date' value
- `500`: Internal error
- `503`: Timeline upload is temporarily unavailable

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)