---
title: "Get daily leaderboard"
method: GET
path: "/api/v1/leaderboard/daily"
tags: ["Leaderboard"]
---

# Get daily leaderboard

`GET /api/v1/leaderboard/daily`

Returns the daily leaderboard of coding time. Public, no authentication required. The leaderboard is cached and regenerated periodically.

## Response `200`

successful

- object
  - `period` string
  - `start_date` string, date
  - `date_range` string
  - `generated_at` string, date_time
  - `entries` LeaderboardEntry[]
    - `rank` integer
    - `user` object
      - `id` integer
      - `username` string
      - `avatar_url` string
    - `total_seconds` number — Total coding duration in seconds for the period

## Other responses

- `503` — service unavailable — Leaderboard is being generated

## Changes

- **2026-06-07** (v1) `10d87f00ef0b` — 1 info
  - the endpoint scheme security `Bearer AND ApiKeyAuth` was removed from the API
- **2026-01-27** (v1) `b6d6849481da` — 1 info
  - the endpoint scheme security `Bearer AND ApiKeyAuth` was added to the API

[Change history](https://skmtc.dev/hackclub/apis/hackatime-api/changes/api/v1/leaderboard/daily/get.md)

---

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