API Docs

NexTiersz API

Official REST API for Minecraft PvP rankings, player profiles, and tier systems. Build bots, dashboards, and tools with real-time competitive data.

Base URL

https://api.nextiersz.com

Root endpoint for all system data.

Status

Public / v1

No authentication required for public endpoints.

Player Rankings

GET /api/players

Response Example

[
  {
    "name": "zMarkitos_",
    "region": "SA",
    "retired": false,
    "tiers": {
      "Netherite Pot": "HT1",
      "Crystal": { "rank": "LT2", "retired": false },
      "Sword": "HT3"
    }
  }
]

Staff Team

GET /team

Response Example

[
  {
    "username": "zmarkitos_",
    "mc_nickname": "zMarkitos_",
    "role": "owner"
  }
]

Banned Players

GET /bans

Response Example

[
  {
    "username": "ToxicPlayer",
    "mc_nickname": "ToxicPlayer",
    "reason": "Unfair Advantage"
  }
]

Partners & Networks

GET /partners

Response Example

[
  {
    "id": 3,
    "partner_type": "server",
    "server_name": "FlaryxMC",
    "ip": "flaryxmc.com",
    "link": "https://discord.flaryxmc.com",
    "description": "Optimized, secure server with unique features",
    "logo": "https://media.discordapp.net/..."
  }
]

Ranking System

Points per Tier

HT1: 60pts LT1: 45pts HT2: 30pts LT2: 20pts HT3: 10pts

Global Roles

Ascendant: 400+ Elite: 250+ Challenger: 100+