---
title: "Grant XP to User"
method: POST
path: "/api/v3/lootbox/users/{user_id}/xp"
tags: ["Lootbox"]
---

# Grant XP to User

`POST /api/v3/lootbox/users/{user_id}/xp`

Add XP to a user and return their previous and new totals.

## Path parameters

- `user_id` integer, required

## Request body

- XpGrantRequest
  - `amount` integer, required
  - `type` 'Map Submission' | 'Playtest' | 'Guide' | 'Completion' | 'Record' | 'World Record' | 'Quest' | 'Other' | 'Tournament', required
  - `reason` string, nullable

## Response `200`

Request fulfilled, document follows

- XpGrantResponse
  - `previous_amount` integer, required
  - `new_amount` integer, required

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api/versions/6db12055b305/schema)