---
title: "Get user stats"
method: GET
path: "/api/v1/users/{username}/stats"
tags: ["Stats"]
---

# Get user stats

`GET /api/v1/users/{username}/stats`

User has disabled public stats lookup

## Path parameters

- `username` string, required

## Query parameters

- `start_date` string
- `end_date` string
- `limit` integer
- `features` string
- `filter_by_project` string
- `filter_by_category` string
- `boundary_aware` boolean
- `total_seconds` boolean

## Response `200`

successful

- object
  - `data` StatsSummary
    - `total_seconds` number
    - `daily_average` number
    - `languages` object[]
      - `name` string
      - `total_seconds` number
      - `percent` number
    - `projects` object[]
      - `name` string
      - `total_seconds` number
      - `percent` number
    - `editors` object[]
      - `name` string
      - `total_seconds` number
      - `percent` number
  - `trust_factor` object
    - `trust_level` string
    - `trust_value` integer

## Other responses

- `403` — forbidden
- `404` — user not found

## Changes

- **2026-01-27** (v1) `b6d6849481da` — 1 breaking, 2 warning, 18 info
  - the `data` response's property type changed from no type to `object` for status `200`
  - deleted the `query` request parameter `no_ai_coding`
  - deleted the `query` request parameter `test_param`
  - the endpoint scheme security `Bearer AND ApiKeyAuth` was added to the API
  - …17 more

[Change history](https://skmtc.dev/hackclub/apis/hackatime-api/changes/api/v1/users/:username/stats/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/b6d6849481da/schema)