---
title: "Get Xp"
method: GET
path: "/api/xp/{user_id}"
tags: ["XP"]
---

# Get Xp

`GET /api/xp/{user_id}`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/xp/{user_id}`
- Auth: HTTP bearer

Get user's current XP status, level, and recent history.

## Path parameters

- `user_id` string, uuid, required

## Response `200`

Successful Response

- XPResponse
  - `user_id` string, required
  - `total_xp` integer, required
  - `level` integer, required
  - `level_name` string, required
  - `xp_to_next_level` integer, nullable, required
  - `xp_current_level` integer, required
  - `xp_next_level` integer, nullable, required
  - `weekly_xp` integer, required
  - `streak_weeks` integer, required
  - `xp_history` XPHistoryEntry[], required
    - `action` string, required
    - `xp` integer, required
    - `date` string, required
    - `description` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)