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

# Get weekly leaderboard

`GET /api/v1/leaderboard/weekly`

Returns the weekly leaderboard of coding time (last 7 days). Public, no authentication required.

## 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

> 27 revisions in range; 3 could not be searched.

- **2026-06-07** (v1) `10d87f00ef0b` — 2 info
  - the endpoint scheme security `Bearer AND ApiKeyAuth` was removed from the API
  - added the non-success response with the status `503`
- **2026-01-27** (v1) `b6d6849481da` — 2 info
  - the endpoint scheme security `Bearer AND ApiKeyAuth` was added to the API
  - removed the non-success response with the status `503`

[Change history](https://skmtc.dev/hackclub/apis/hackatime-api/changes/api/v1/leaderboard/weekly/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)