CactusTiers API
Official API for retrieving CactusTiers player profiles and rankings. This is a public, read-only REST API that returns JSON.
Base URL
All endpoints are served from:
https://tiers.cactusmc.xyzAuthentication
No authentication is required. Endpoints are publicly accessible.
Get a player profile
GET
/api/profile/{username}Returns a player's profile and per-mode rankings.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| username | string | required | Minecraft username (case-insensitive). |
Example request
curl https://tiers.cactusmc.xyz/api/profile/CuteeCactus200 — Player found
{
"uuid": null,
"premium": null,
"name": "CuteeCactus",
"region": "NA",
"points": 500,
"overall": 1,
"badges": [],
"rankings": {
"sword": {
"display": "HT1",
"tier": 1,
"pos": 1,
"peak_tier": 1,
"peak_pos": 1,
"attained": 0,
"retired": false
}
}
}404 — Player not found
{
"error": "Player not found"
}Try it
Enter a Minecraft username to call the endpoint live.
Profile
| Field | Type | Description |
|---|---|---|
| uuid | string | null | Minecraft UUID without dashes. |
| premium | boolean | null | Whether the account is premium. |
| name | string | Minecraft username. |
| region | AS | PK | NA | EU | ME | Player region. |
| points | integer | Total ranking points. |
| overall | integer | Global leaderboard position. |
| badges | string[] | List of badge IDs. |
| rankings | map<string, Ranking> | Per-mode rankings keyed by mode ID. |
Ranking
| Field | Type | Description |
|---|---|---|
| display | string | Original tier string (e.g. HT1, LT3, RHT2). |
| tier | integer (1–5) | Tier number. |
| pos | 0 | 1 | 0 = Low Tier, 1 = High Tier. |
| peak_tier | integer | null | Best tier achieved. |
| peak_pos | 0 | 1 | null | Best position achieved. |
| attained | integer (unix) | Timestamp when tier was earned. |
| retired | boolean | Whether the ranking is retired. |
Error
| Field | Type | Description |
|---|---|---|
| error | string | Human-readable error message. |