v7

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-01426118.4 KB
Admin Timeline

Get timeline

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

get/api/admin/v1/timeline

Query parameters

datestring date

Date for the timeline (YYYY-MM-DD)

user_idsstring

Comma-separated list of User IDs

slack_uidsstring

Comma-separated list of Slack User IDs

Response

successful

datestring date
next_datestring date
prev_datestring date

Example response

{
  "date": "2024-03-20",
  "next_date": "2024-03-21",
  "prev_date": "2024-03-19",
  "users": [
    {
      "user": {
        "id": 42,
        "username": "orpheus",
        "display_name": "orpheus",
        "slack_username": "orpheus",
        "github_username": "orpheus",
        "timezone": "America/New_York",
        "avatar_url": "https://avatars.slack-edge.com/2024-03-20/orpheus_512.png"
      },
      "spans": [
        {
          "start_time": 1710946200,
          "end_time": 1710949800,
          "duration": 3600,
          "files_edited": [
            "app/models/user.rb"
          ],
          "projects_edited_details": [
            {
              "name": "hackatime",
              "repo_url": "https://github.com/hackclub/hackatime"
            }
          ],
          "editors": [
            "VS Code"
          ],
          "languages": [
            "Ruby"
          ]
        }
      ],
      "total_coded_time": 7200
    }
  ],
  "commit_markers": [
    {
      "user_id": 42,
      "timestamp": 1710948000,
      "additions": 120,
      "deletions": 18,
      "github_url": "https://github.com/hackclub/hackatime/commit/a1b2c3d"
    }
  ]
}