---
title: "Get User Skill History"
method: GET
path: "/api/v3/skill/users/{user_id}/history"
tags: ["Skill"]
---

# Get User Skill History

`GET /api/v3/skill/users/{user_id}/history`

Return the player's time-windowed score history (oldest-first points) plus a summary (best/lowest/average, first-vs-last point and percent change). A player with no history returns an empty points list and a zeroed summary (never 500). An unknown window value is rejected at decode (4xx).

## Path parameters

- `user_id` integer, required

## Query parameters

- `window` '7d' | '30d' | '90d' | '1y' | 'all' — Time window (7d/30d/90d/1y/all)

## Response `200`

Request fulfilled, document follows

- SkillHistoryResponse
  - `user_id` integer, required
  - `points` SkillHistoryPoint[], required
    - `captured_at` string, date-time, required
    - `skill_score` number, required
  - `summary` SkillHistorySummary, required
    - `point_change` number, required
    - `percent_change` number, nullable
    - `best` SkillHistoryExtremum, required
      - `score` number, required
      - `date` string, date-time, nullable
    - `lowest` SkillHistoryExtremum, required
      - `score` number, required
      - `date` string, date-time, nullable
    - `average` number, required

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.dev/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.dev/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genji/apis/genji-shimada-api/revisions/8d8731ebc592?raw)