---
title: "Get timeline"
method: GET
path: "/api/admin/v1/timeline"
tags: ["Admin Timeline"]
---

# Get timeline

`GET /api/admin/v1/timeline`

Get timeline events including coding activity and commits for selected users.

## Query parameters

- `date` string, date
- `user_ids` string
- `slack_uids` string

## Response `200`

successful

- object
  - `date` string, date
  - `next_date` string, date
  - `prev_date` string, date
  - `users` object[]
    - `user` object
      - `id` integer
      - `username` string
      - `display_name` string, nullable
      - `slack_username` string, nullable
      - `github_username` string, nullable
      - `timezone` string, nullable
      - `avatar_url` string, nullable
    - `spans` object[]
      - `start_time` number, float
      - `end_time` number, float
      - `duration` number, float
      - `files_edited` string[]
      - `projects_edited_details` object[]
        - `name` string
        - `repo_url` string, nullable
      - `editors` string[]
      - `languages` string[]
    - `total_coded_time` number, float
  - `commit_markers` object[]
    - `user_id` integer
    - `timestamp` number, float
    - `additions` integer, nullable
    - `deletions` integer, nullable
    - `github_url` string, nullable

## Other responses

- `401` — unauthorized
- `422` — invalid date format

---

[API](https://skmtc.dev/hackclub/apis/hackatime-admin-api.md) · [All operations](https://skmtc.dev/hackclub/apis/hackatime-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hackclub/hackatime-admin-api/revisions/f5a2d53cd28d/schema)