API Documentation

Access ban tracking data programmatically through our REST API

Base URL

https://api.bans.live/v1

Authentication

API requests require an API key. You can obtain an API key by contacting us.

Header:

Authorization: Bearer YOUR_API_KEY

Endpoints

GET/player/{name}

Get ban information for a specific player

GET /api/v1/player/PlayerName

GET/bans/latest

Get the latest bans

GET /api/v1/bans/latest?limit=50

GET/stats

Get overall statistics

GET /api/v1/stats

GET/leaderboard

Get leaderboard data

GET /api/v1/leaderboard?period=month

Rate Limits

Free tier: 100 requests per hour
Pro tier: 1,000 requests per hour
Enterprise: Custom limits

Response Format

All API responses are returned in JSON format:

{
  "success": true,
  "data": {
    "player": "PlayerName",
    "bans": 12,
    "status": "banned"
  }
}