Developers

API Docs

Access Apex Legends ban data, ban waves, player stats and match history, leaderboards, the Predator cutoff and its forecast, legend and weapon meta, split recaps, and server status via our REST API.

8 sections

The short version

1Plain REST over HTTPS: 55 endpoints under api.apexbantracker.com/api/v1, all returning JSON with UTC ISO 8601 timestamps.
2Every request carries your bp_ key — the Authorization: Bearer header is recommended; X-Api-Key or the api_key query parameter also work.
3Monthly plans from $5. Every plan includes every endpoint; the tiers differ only in rate limits.
4Over a limit you get 429 with a Retry-After header. The Atom feeds need no key and don't count against a plan.

Quick Start

Get up and running in under a minute. Here's how to make your first API call:

Base URL

HTTPS

https://api.apexbantracker.com/api/v1

1
Get your API key
Sign up and subscribe to a plan from the developer dashboard. You'll receive an API key starting with bp_.

Make a request

Pass your API key in the Authorization header:

Shell

curl -X GET "https://api.apexbantracker.com/api/v1/stats" \
  -H "Authorization: Bearer bp_your_api_key_here"

Parse the JSON response

JSON

{
  "totalTrackedPlayers": 15000,
  "masterPlusPlayers": 5000,
  "bannedPlayers": 1250,
  "activePlayers": 13750
}

Code examples

Python

import requests

API_KEY = "bp_your_api_key_here"
BASE_URL = "https://api.apexbantracker.com/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Get player by UID
response = requests.get(f"{BASE_URL}/player/1234567890", headers=headers)
player = response.json()
print(f"{player['username']} - Rank: {player['rankTier']} ({player['rankScore']} RP)")

# Search for players
response = requests.get(f"{BASE_URL}/players/search", params={"q": "ninja", "limit": 5}, headers=headers)
for p in response.json():
    print(f"  {p['username']} ({p['platform']}) - {p['rankScore']} RP")

JavaScript / Node.js

const API_KEY = "bp_your_api_key_here";
const BASE_URL = "https://api.apexbantracker.com/api/v1";

const headers = { Authorization: `Bearer ${API_KEY}` };

// Get player by UID
const playerRes = await fetch(`${BASE_URL}/player/1234567890?platform=PC`, { headers });
const player = await playerRes.json();
console.log(`${player.username} - ${player.rankTier} (${player.rankScore} RP)`);

// Get recent bans
const bansRes = await fetch(`${BASE_URL}/bans/recent?limit=5`, { headers });
const bans = await bansRes.json();
bans.forEach(b => console.log(`${b.username} banned at ${b.bannedAt}`));

C# / .NET

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer bp_your_api_key_here");

var baseUrl = "https://api.apexbantracker.com/api/v1";

// Get player by UID
var playerJson = await client.GetStringAsync($"{baseUrl}/player/1234567890?platform=PC");
Console.WriteLine(playerJson);

// Get leaderboard
var leaderboardJson = await client.GetStringAsync($"{baseUrl}/leaderboard?platform=PC&pageSize=10");
Console.WriteLine(leaderboardJson);

Authentication

All API requests require a valid API key. You can pass your key using any of these methods:

Authorization headerRecommended

Authorization: Bearer bp_your_api_key_here

X-Api-Key header

X-Api-Key: bp_your_api_key_here

Query parameter

GET /api/v1/stats?api_key=bp_your_api_key_here

Query parameter auth is less secure, as the key may appear in server logs. Use a header when possible.

Plans & Pricing

Simple monthly plans, cancel anytime. Every plan includes the full endpoint set — ban data and ban waves, player profiles and history, leaderboards and the Predator cutoff, meta, recaps and server status — the tiers differ only in rate limits.

Basic

$5/month

For hobbyist developers and small projects

2 requests/second
1,000 requests/day
30,000 requests/month
All endpoints included

PlusPopular

$10/month

For professional developers and growing applications

5 requests/second
10,000 requests/day
300,000 requests/month
All endpoints included

Enterprise

$15/month

For large-scale applications and commercial use

15 requests/second
100,000 requests/day
3,000,000 requests/month
All endpoints included

Ban, unban and ban-wave Discord alerts are free with any account — no API plan required. Need higher limits or a custom agreement? Get in touch.

Rate Limits

Rate limits are enforced per API key and vary by plan. When you exceed a limit you'll receive a 429 response with a Retry-After header giving the seconds to wait: 1 for the per-second limit, or the time until the daily or monthly quota resets. Requests turned away by the per-second limit don't count against your daily or monthly quota.

Plan	Price	Per second	Per day	Per month
Basic	$5/mo	2 req/s	1,000 req/day	30,000 req/month
Plus	$10/mo	5 req/s	10,000 req/day	300,000 req/month
Enterprise	$15/mo	15 req/s	100,000 req/day	3,000,000 req/month

To subscribe, create a key from the developer dashboard — see Plans & Pricing above.

Response headers

Every API response includes these headers so you can track your usage:

HTTP

X-RateLimit-Plan: plus
X-RateLimit-Limit-Day: 10000
X-RateLimit-Limit-Second: 5
X-RateLimit-Remaining-Day: 9874
X-RateLimit-Remaining-Month: 287412

X-RateLimit-Plan carries the plan's id: basic, plus or enterprise. The remaining counts reset at 00:00 UTC each day and on the 1st of each month.

Error Codes

All errors return a JSON object with error and code fields:

JSON

{
  "error": "Daily request limit of 1000 exceeded",
  "code": "DAILY_LIMIT"
}

HTTP status	Code	Description
401	MISSING_API_KEY	No API key was provided in the request
400	INVALID_PLATFORM	The platform parameter is not one of PC, PS4, X1 or Switch
401	INVALID_KEY	The API key does not exist or is malformed
403	KEY_SUSPENDED	API key is suspended due to a payment issue
403	KEY_EXPIRED	The subscription associated with this key has expired
403	KEY_REVOKED	This API key has been revoked by the owner
403	IP_NOT_ALLOWED	The request came from an IP address outside this key's allowlist
403	ACCOUNT_DISABLED	The account that owns this key is disabled
429	RATE_LIMITED	You have exceeded your plan's per-second request limit
429	DAILY_LIMIT	You have exceeded your plan's daily request limit
429	MONTHLY_LIMIT	You have exceeded your plan's monthly request limit
404	-	The requested resource was not found, or the player's detail data is not public
500	-	An unexpected server error occurred

Endpoints

All endpoints return JSON. Timestamps are in UTC ISO 8601 format.

55 of 55

Players16Profiles, search, match and RP history, splits, analytics and banners.

GET/api/v1/player/{uid}

Get detailed player information by UID. Returns rank, ban status, online status, current legend, and more.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "platform": "PC",
  "rankScore": 18500,
  "rankTier": "Master",
  "rankLadderPosition": 342,
  "isMasterOrAbove": true,
  "isPredator": false,
  "isBanned": false,
  "banReason": null,
  "bannedAt": null,
  "unbannedAt": null,
  "banCount": 0,
  "currentLegend": "Wraith",
  "accountLevel": 500,
  "isOnline": true,
  "isInMatch": false,
  "lastUpdated": "2026-03-17T12:00:00Z"
}

GET/api/v1/players/search

Search for players by username. Returns a list of matching players sorted by rank score (highest first). Players who set their profile to private are not included.

Parameters

qquery · stringRequired: Username to search for (case-insensitive, partial match)
limitquery · integer: Maximum number of results to return. Range: 1-100, default: 25

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/players/search?q=ninja&limit=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "1234567890",
    "username": "ExamplePlayer",
    "platform": "PC",
    "rankScore": 18500,
    "ladderPosition": 342,
    "isBanned": false,
    "isOnline": true,
    "currentLegend": "Wraith",
    "accountLevel": 500
  }
]

GET/api/v1/player/{uid}/ban-history

Get the ban/unban event history for a specific player. Returns up to 50 events, newest first.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/ban-history" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "eventType": "BAN",
    "eventDate": "2026-02-15T08:30:00Z",
    "reason": null,
    "rankScoreAtBan": 22000,
    "ladderPositionAtBan": 45,
    "banSeconds": 0
  },
  {
    "eventType": "UNBAN",
    "eventDate": "2026-03-01T14:00:00Z",
    "reason": null,
    "rankScoreAtBan": null,
    "ladderPositionAtBan": null,
    "banSeconds": 0
  }
]

GET/api/v1/player/{uid}/matches

Get a player's ranked match history with RP changes, legends used, and kill estimates. Newest first. Returns 404 for players whose profile visibility is limited or private, matching the website.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
limitquery · integer: Maximum number of results. Range: 1-100, default: 50
offsetquery · integer: Number of results to skip for pagination. Default: 0

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/matches?limit=25" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "rpChange": 120,
    "finalRp": 18620,
    "finalLadderPosition": 339,
    "legend": "Wraith",
    "matchTime": "2026-03-17T11:20:00Z",
    "estimatedKills": {
      "minKills": 3,
      "maxKills": 6,
      "mostLikelyKills": 4,
      "mostLikelyPlacement": 2,
      "minPlacement": 2,
      "maxPlacement": 3,
      "confidence": "medium"
    }
  }
]

GET/api/v1/player/{uid}/rp-history

Get a player's all-time RP curve, downsampled to one point per UTC day (the day's final match). Returns 404 for players whose profile visibility is limited or private, matching the website.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/rp-history" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "date": "2026-03-16T00:00:00Z",
    "rp": 18500,
    "ladderPosition": 342
  },
  {
    "date": "2026-03-17T00:00:00Z",
    "rp": 18620,
    "ladderPosition": 339
  }
]

GET/api/v1/player/{uid}/aliases

Get the full username (alias) history recorded for a player, newest first. Returns 404 for players whose profile visibility is limited or private, matching the website.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/aliases" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "username": "CurrentName",
    "firstSeenAt": "2026-02-01T10:00:00Z",
    "lastSeenAt": "2026-03-17T12:00:00Z"
  },
  {
    "username": "OldName",
    "firstSeenAt": "2025-11-12T08:00:00Z",
    "lastSeenAt": "2026-01-31T22:00:00Z"
  }
]

GET/api/v1/players/batch

Look up to 60 players at once by name or UID: rank, ban status and ban count for each, in request order, plus the platform's Predator cutoff. Private profiles come back as private with no data.

Parameters

namesquery · stringRequired: Comma-separated names or UIDs, up to 60
platformquery · string: Platform to resolve names on: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/players/batch?names=ExamplePlayer,AnotherPlayer&platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "predatorCutoff": 18500,
  "truncated": false,
  "results": [
    {
      "query": "ExamplePlayer",
      "status": "up",
      "player": {
        "uid": "1234567890",
        "platform": "PC",
        "username": "ExamplePlayer",
        "rankTier": "Master",
        "rankScore": 18500,
        "ladderPosition": 18500,
        "isPredator": false,
        "banState": "banned",
        "banCount": 125,
        "visibility": "public",
        "allowIndexing": false,
        "linkedAccounts": 125,
        "lastActiveAt": "2026-10-16T12:00:00Z",
        "isOnline": false,
        "isInMatch": false,
        "currentLegend": "Wraith",
        "accountLevel": 125,
        "playedCurrentSplit": false,
        "predBubble": false,
        "openCase": false,
        "linkedToSuspect": false
      }
    }
  ]
}

POST/api/v1/players/batch

The same lookup as GET /api/v1/players/batch, taking a JSON body instead of a query string. Use it for long lists.

Parameters

namesbody · string[]Required: Names or UIDs, up to 60
platformbody · string: Platform to resolve names on: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X POST "https://api.apexbantracker.com/api/v1/players/batch" \
  -H "Authorization: Bearer bp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"names":["ExamplePlayer","AnotherPlayer"],"platform":"PC"}'

Example response

JSON

{
  "platform": "PC",
  "predatorCutoff": 18500,
  "truncated": false,
  "results": [
    {
      "query": "ExamplePlayer",
      "status": "up",
      "player": {
        "uid": "1234567890",
        "platform": "PC",
        "username": "ExamplePlayer",
        "rankTier": "Master",
        "rankScore": 18500,
        "ladderPosition": 18500,
        "isPredator": false,
        "banState": "banned",
        "banCount": 125,
        "visibility": "public",
        "allowIndexing": false,
        "linkedAccounts": 125,
        "lastActiveAt": "2026-10-16T12:00:00Z",
        "isOnline": false,
        "isInMatch": false,
        "currentLegend": "Wraith",
        "accountLevel": 125,
        "playedCurrentSplit": false,
        "predBubble": false,
        "openCase": false,
        "linkedToSuspect": false
      }
    }
  ]
}

GET/api/v1/players/top

Top tracked players by one career stat. Banned accounts and duplicate linked accounts are excluded.

Parameters

statquery · string: kills, damage, wins, matches or level. Default: kills
platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50
qquery · string: Find one player by name or UID within the ranking

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/players/top?stat=kills&platform=PC&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalCount": 125,
  "page": 1,
  "pageSize": 1,
  "stat": "kills",
  "platform": "PC",
  "query": "ExamplePlayer",
  "players": [
    {
      "rank": 342,
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "rankScore": 18500,
      "rankTier": "Master",
      "isPredator": false,
      "accountLevel": 125,
      "value": 4210,
      "mainLegend": "Wraith"
    }
  ]
}

GET/api/v1/player/{uid}/splits

The ranked splits a player has matches in, newest first. Use a split id with rp-progression and analytics.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/splits" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "splitId": "29-2",
    "firstSeen": "2026-10-16T12:00:00Z",
    "lastSeen": "2026-10-16T12:00:00Z",
    "isCurrent": false,
    "displayName": "ExamplePlayer"
  }
]

GET/api/v1/player/{uid}/rp-progression

Match-by-match RP for one ranked split, including past splits. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
splitquery · stringRequired: Split id from /player/{uid}/splits, such as 29-2
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/rp-progression?split=29-2" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "timestamp": "2026-10-16T12:00:00Z",
    "rp": 18500,
    "rpChange": 18500,
    "isAnomaly": false,
    "legend": "Wraith",
    "ladderPosition": 18500,
    "estimatedKills": {
      "expectedScoreUnits": 18500,
      "expectedKillsAssists": 4.1,
      "minKills": 3,
      "maxKills": 6,
      "mostLikelyKills": 4,
      "mostLikelyPlacement": 2,
      "minPlacement": 1,
      "maxPlacement": 3,
      "confidence": "none"
    },
    "rpBreakdown": {
      "entryCost": -35,
      "earned": 410,
      "placementRp": 18500,
      "killRp": 18500,
      "basis": "entry"
    },
    "splitId": "29-2",
    "accountLevelAtMatch": 125,
    "map": "E-District",
    "matchDurationSeconds": 1260,
    "observedPlacement": 2,
    "confirmedSquadmates": [
      {
        "uid": "1234567890",
        "username": "ExamplePlayer",
        "platform": "PC"
      }
    ]
  }
]

GET/api/v1/player/{uid}/analytics

A player's analytics: legend usage, RP gained and lost, and per-match RP progression, for a rolling window or one split. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
daysquery · integer: Rolling window in days when no split is given. Default: 30
splitquery · string: Split id from /player/{uid}/splits. Scopes every figure to that split.
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/analytics?split=29-2" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "playerUid": "1234567890",
  "playerName": "ExamplePlayer",
  "currentRp": 18500,
  "currentLadderPosition": 18500,
  "rankTier": "Master",
  "isBanned": false,
  "matchCount": 125,
  "totalRpChange": 18500,
  "totalRpGained": 18500,
  "totalRpLost": 18500,
  "averageRpPerMatch": 18500,
  "bestMatchRp": 18500,
  "worstMatchRp": 18500,
  "analysisPeriodDays": 30,
  "splitId": "29-2",
  "isCurrentSplit": false,
  "estimatedTotalKills": 125,
  "estimatedKillsMatchCount": 125,
  "estimatedKillsPerMatch": 3.2,
  "estimatedScoreUnitsPerMatch": 18500,
  "predatorThresholdRp": 18500,
  "characterUsage": [
    {
      "legend": "Wraith",
      "matchCount": 125,
      "totalRpChange": 18500,
      "averageRpChange": 18500
    }
  ],
  "rpProgression": [
    {
      "timestamp": "2026-10-16T12:00:00Z",
      "rp": 18500,
      "rpChange": 18500,
      "isAnomaly": false,
      "legend": "Wraith",
      "ladderPosition": 18500,
      "estimatedKills": {
        "expectedScoreUnits": 18500,
        "expectedKillsAssists": 4.1,
        "minKills": 3,
        "maxKills": 6,
        "mostLikelyKills": 4,
        "mostLikelyPlacement": 2,
        "minPlacement": 1,
        "maxPlacement": 3,
        "confidence": "none"
      },
      "rpBreakdown": {
        "entryCost": -35,
        "earned": 410,
        "placementRp": 18500,
        "killRp": 18500,
        "basis": "entry"
      },
      "splitId": "29-2",
      "accountLevelAtMatch": 125,
      "map": "E-District",
      "matchDurationSeconds": 1260,
      "observedPlacement": 2,
      "confirmedSquadmates": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "platform": "PC"
        }
      ]
    }
  ],
  "confirmedSquadmatesHistory": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "platform": "PC",
      "games": 14,
      "totalRpChange": 18500,
      "wins": 8,
      "losses": 6,
      "rankTier": "Master",
      "rankScore": 18500,
      "isBanned": false,
      "bannedAt": "2026-10-16T12:00:00Z",
      "firstPlayedWithAt": "2026-10-16T12:00:00Z",
      "lastPlayedWithAt": "2026-10-16T12:00:00Z",
      "affinityScore": 18500
    }
  ],
  "percentiles": {
    "populationSize": 14000,
    "rp": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeKills": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeDamage": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeWins": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeMatches": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "accountLevel": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    }
  }
}

GET/api/v1/player/{uid}/tracker-percentiles

Where each of a player's banner trackers ranks among players on the same platform with the same legend and tracker. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/tracker-percentiles" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "characterId": 1,
    "trackerStatId": 1,
    "value": 4210,
    "rank": 342,
    "topPercent": 12.5,
    "population": 14000
  }
]

GET/api/v1/player/{uid}/banner

Every badge and tracker seen on a player's banner, with when each was first and last seen. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/banner" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "playerUid": "1234567890",
  "badges": [
    {
      "badgeId": 1,
      "tierValue": 3,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z"
    }
  ],
  "trackers": [
    {
      "characterId": 1,
      "trackerStatId": 1,
      "lastValue": 4210,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z"
    }
  ]
}

GET/api/v1/streamers

Streamers who have linked their Apex account and are listed in the site's streamer directory, with live status.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/streamers" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "streamers": [
    {
      "uid": "1234567890",
      "platform": "PC",
      "username": "ExamplePlayer",
      "rankScore": 18500,
      "ladderPosition": 18500,
      "accountLevel": 125,
      "isPredator": false,
      "twitchUsername": "ExamplePlayer",
      "youtubeChannel": null,
      "xHandle": null,
      "country": "US",
      "inputMethod": "mnk",
      "isLive": false,
      "streamTitle": "Ranked grind",
      "streamGame": "Apex Legends",
      "viewerCount": 125,
      "liveSince": "2026-10-16T12:00:00Z",
      "isBanned": false,
      "rpThisStream": 18500,
      "currentLegend": "Wraith",
      "lastLiveAt": "2026-10-16T12:00:00Z"
    }
  ],
  "liveCount": 125,
  "totalCount": 125
}

Bans16The ban list, ban waves, ban rate, Fallen Predators and ban statistics.

GET/api/v1/bans

Get all currently banned players with pagination.

Parameters

pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Number of results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans?page=1&pageSize=25" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalCount": 1250,
  "page": 1,
  "pageSize": 25,
  "totalPages": 50,
  "players": [
    {
      "uid": "9876543210",
      "username": "BannedPlayer",
      "platform": "PC",
      "rankScore": 20000,
      "rankTier": "Master",
      "rankLadderPosition": -1,
      "isBanned": true,
      "bannedAt": "2026-03-10T14:00:00Z",
      "banCount": 2,
      "lastUpdated": "2026-03-17T08:00:00Z"
    }
  ]
}

GET/api/v1/bans/recent

Get the most recently banned players. Useful for monitoring new bans as they happen.

Parameters

limitquery · integer: Maximum number of results. Range: 1-100, default: 10

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/recent?limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "9876543210",
    "username": "RecentlyBanned",
    "platform": "PC",
    "rankScore": 19000,
    "rankTier": "Master",
    "rankLadderPosition": -1,
    "bannedAt": "2026-03-17T10:00:00Z",
    "banCount": 1,
    "lastUpdated": "2026-03-17T10:05:00Z"
  }
]

GET/api/v1/bans/recent-unbans

Get players who were recently unbanned. Useful for tracking false-positive ban reversals.

Parameters

limitquery · integer: Maximum number of results. Range: 1-100, default: 10

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/recent-unbans?limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "5555555555",
    "username": "RecentlyUnbanned",
    "platform": "PC",
    "rankScore": 17000,
    "rankTier": "Master",
    "rankLadderPosition": 200,
    "unbannedAt": "2026-03-16T20:00:00Z",
    "banCount": 1,
    "lastUpdated": "2026-03-16T20:05:00Z"
  }
]

GET/api/v1/bans/search

Search within banned players by username or UID.

Parameters

qquery · stringRequired: Username or UID to search for (case-insensitive, partial match)
limitquery · integer: Maximum number of results. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/search?q=cheater&limit=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "9876543210",
    "username": "BannedPlayer",
    "platform": "PC",
    "rankScore": 20000,
    "rankTier": "Master",
    "rankLadderPosition": -1,
    "isBanned": true,
    "bannedAt": "2026-03-10T14:00:00Z",
    "banCount": 2,
    "lastUpdated": "2026-03-17T08:00:00Z"
  }
]

GET/api/v1/bans/most-banned

Get the players with the highest all-time ban counts (repeat offenders with 2+ bans), sorted by ban count.

Parameters

limitquery · integer: Maximum number of results. Range: 1-50, default: 10

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/most-banned?limit=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "9876543210",
    "username": "RepeatOffender",
    "tag": null,
    "platform": "PC",
    "rankTier": "ApexPredator",
    "rankScore": 22000,
    "isPredator": true,
    "isBanned": true,
    "banCount": 5,
    "lastBannedAt": "2026-03-15T09:00:00Z"
  }
]

GET/api/v1/stats/ban-stats

Get detailed aggregated ban statistics: current vs all-time bans, Predator vs Master splits, temp bans, repeat offenders, and last-24h activity.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-stats" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalBans": 1250,
  "allTimeBans": 3400,
  "predatorBans": 400,
  "masterBans": 700,
  "otherBans": 150,
  "tempBans": 120,
  "repeatOffenders": 90,
  "last24Hours": 35
}

GET/api/v1/bans/waves

Detected ban waves, newest first, plus the wave in progress if there is one. A wave is a stretch where the hourly ban rate runs well above its 7-day baseline.

Parameters

daysquery · integer: How far back to look, in days. Range: 1-365, default: 90

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/waves?days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "activeWave": {
    "id": 1,
    "startedAt": "2026-10-16T12:00:00Z",
    "endedAt": null,
    "banCount": 125,
    "peakHourlyRate": 12.5,
    "baselineHourlyRate": 12.5,
    "durationMinutes": 95,
    "mix": {
      "platform": "PC",
      "tier": "Master",
      "count": 125,
      "ranked": 342
    }
  },
  "waves": [
    {
      "id": 1,
      "startedAt": "2026-10-16T12:00:00Z",
      "endedAt": "2026-10-16T12:00:00Z",
      "banCount": 125,
      "peakHourlyRate": 12.5,
      "baselineHourlyRate": 12.5,
      "durationMinutes": 95,
      "mix": {
        "platform": "PC",
        "tier": "Master",
        "count": 125,
        "ranked": 342
      }
    }
  ]
}

GET/api/v1/bans/waves/{id}

One ban wave with its full roster: every ban detected inside the wave window, with each account's name, platform, RP and ladder position at the ban.

Parameters

idpath · integerRequired: The wave id, from /api/v1/bans/waves

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/waves/42" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "wave": {
    "id": 1,
    "startedAt": "2026-10-16T12:00:00Z",
    "endedAt": "2026-10-16T12:00:00Z",
    "banCount": 125,
    "peakHourlyRate": 12.5,
    "baselineHourlyRate": 12.5,
    "durationMinutes": 95,
    "mix": {
      "platform": "PC",
      "tier": "Master",
      "count": 125,
      "ranked": 342
    }
  },
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "platform": "PC",
      "eventDate": "2026-10-16T12:00:00Z",
      "rankScoreAtBan": 18500,
      "ladderPositionAtBan": 18500,
      "banSeconds": 125,
      "confidenceLevel": "medium",
      "inferredRegion": "NA"
    }
  ]
}

GET/api/v1/bans/rate

Hourly ban counts over a rolling window, with the 7-day baseline rate, anti-cheat update markers and any waves overlapping the window.

Parameters

hoursquery · integer: Window length in hours. Range: 6-168, default: 48

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/rate?hours=48" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "buckets": [
    {
      "hourStart": "2026-10-16T11:00:00Z",
      "count": 125
    }
  ],
  "baselineHourly": 3.4,
  "eacUpdates": [
    {
      "detectedAt": "2026-10-16T12:00:00Z",
      "changeNumber": "1",
      "system": "EA Login"
    }
  ],
  "waves": [
    {
      "id": 1,
      "startedAt": "2026-10-16T12:00:00Z",
      "endedAt": "2026-10-16T12:00:00Z",
      "banCount": 125,
      "peakHourlyRate": 12.5,
      "baselineHourlyRate": 12.5,
      "durationMinutes": 95,
      "mix": {
        "platform": "PC",
        "tier": "Master",
        "count": 125,
        "ranked": 342
      }
    }
  ],
  "activeWave": {
    "id": 1,
    "startedAt": "2026-10-16T12:00:00Z",
    "endedAt": "2026-10-16T12:00:00Z",
    "banCount": 125,
    "peakHourlyRate": 12.5,
    "baselineHourlyRate": 12.5,
    "durationMinutes": 95,
    "mix": {
      "platform": "PC",
      "tier": "Master",
      "count": 125,
      "ranked": 342
    }
  }
}

GET/api/v1/bans/daily-top

The biggest names banned on each UTC day of the window, highest RP at ban first.

Parameters

daysquery · integer: Window length in days. Range: 1-90, default: 90

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/daily-top?days=7" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "days": [
    {
      "date": "2026-10-16T12:00:00Z",
      "players": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "platform": "PC",
          "eventDate": "2026-10-16T12:00:00Z",
          "rankScoreAtBan": 18500,
          "ladderPositionAtBan": 18500,
          "banSeconds": 125,
          "confidenceLevel": "medium",
          "inferredRegion": "NA"
        }
      ]
    }
  ]
}

GET/api/v1/bans/fallen-predators

Banned players who hold Predator season badges, with their per-season badge shelf and totals.

Parameters

platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
seasonquery · integer: Only players with a Predator badge from this ranked season
sortquery · string: recent (newest ban first), placement (best ladder slot first), season (newest season first) or badges (most Predator badges first). Default: recent
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-96, default: 48

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/fallen-predators?platform=PC&sort=recent&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalPlayers": 125,
  "totalBadges": 125,
  "topTenPlayers": 10,
  "latestBanAt": "2026-10-16T12:00:00Z",
  "seasons": [
    {
      "season": 29,
      "players": 5000,
      "bestPlacement": 1
    }
  ],
  "platform": "PC",
  "season": 29,
  "sort": "recent",
  "page": 1,
  "pageSize": 1,
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "accountLevel": 125,
      "bannedAt": "2026-10-16T12:00:00Z",
      "banSeconds": 125,
      "rankScoreAtBan": 18500,
      "ladderPositionAtBan": 18500,
      "bestPlacement": 1,
      "newestSeason": 29,
      "badges": [
        {
          "badgeId": 1,
          "season": 29,
          "ladderPosition": 18500,
          "tierValue": 3,
          "firstSeenAt": "2026-10-16T12:00:00Z",
          "lastSeenAt": "2026-10-16T12:00:00Z"
        }
      ]
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/bans/fallen-predators/{uid}

One banned player's Predator season badges. Returns 404 when the player isn't currently banned or holds no Predator badge.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/fallen-predators/1234567890" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "tag": null,
  "platform": "PC",
  "accountLevel": 125,
  "bannedAt": "2026-10-16T12:00:00Z",
  "banSeconds": 125,
  "rankScoreAtBan": 18500,
  "ladderPositionAtBan": 18500,
  "bestPlacement": 1,
  "newestSeason": 29,
  "badges": [
    {
      "badgeId": 1,
      "season": 29,
      "ladderPosition": 18500,
      "tierValue": 3,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z"
    }
  ]
}

GET/api/v1/bans/official-reconciliation

Official EA/Respawn ban announcements next to the number of bans this tracker detected in each announced window.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/official-reconciliation" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "announcements": [
    {
      "id": 1,
      "announcedAt": "2026-10-16T12:00:00Z",
      "windowStart": "2026-10-15T12:00:00Z",
      "windowEnd": "2026-10-16T12:00:00Z",
      "bannedCount": 125,
      "rpRemoved": 18500,
      "source": "tracker",
      "sourceUrl": "https://example.com/",
      "notes": null,
      "trackerDetections": 41
    }
  ]
}

GET/api/v1/stats/ban-trends

Daily ban and unban counts.

Parameters

daysquery · integer: Window length in days. Range: 1-365, default: 90

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-trends?days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "date": "2026-10-16T12:00:00Z",
    "bans": 125,
    "unbans": 125
  }
]

GET/api/v1/stats/ban-timeline

Daily ban and unban counts as a chart-ready time series.

Parameters

daysquery · integer: Window length in days. Range: 1-365, default: 90. Values outside the range return 400.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-timeline?days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "date": "2026-10-16T12:00:00Z",
    "bans": 125,
    "unbans": 125,
    "predatorBans": 125
  }
]

GET/api/v1/stats/ban-breakdown

Current bans broken down by platform, rank tier and ban type.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-breakdown" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platformBreakdown": [
    {
      "label": "Master",
      "count": 125
    }
  ],
  "rankBreakdown": [
    {
      "label": "Master",
      "count": 125
    }
  ],
  "banTypeBreakdown": [
    {
      "label": "Master",
      "count": 125
    }
  ]
}

Ranked12Leaderboards, the Predator cutoff and its forecast, rank distribution, map rotation and lobbies.

GET/api/v1/leaderboard

Get the ranked leaderboard for a specific platform. Returns top players sorted by ladder position.

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/leaderboard?platform=PC&page=1&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "totalCount": 750,
  "page": 1,
  "pageSize": 10,
  "predatorThresholdRp": 25000,
  "predatorCount": 750,
  "masterCount": 5000,
  "players": [
    {
      "uid": "1111111111",
      "username": "TopPredator",
      "platform": "PC",
      "rankScore": 35000,
      "rankTier": "Apex Predator",
      "rankLadderPosition": 1,
      "currentLegend": "Bangalore",
      "isOnline": false,
      "isInMatch": false,
      "accountLevel": 500,
      "lastUpdated": "2026-03-17T11:30:00Z"
    }
  ]
}

GET/api/v1/leaderboard/movers

Get the biggest RP gainers and losers over a rolling window, aggregated from recent matches.

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC
windowHoursquery · integer: Rolling window in hours. Range: 1-24, default: 1
limitquery · integer: Maximum gainers/losers each. Range: 1-50, default: 5

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/leaderboard/movers?platform=PC&windowHours=1&limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "gainers": [
    {
      "uid": "1111111111",
      "username": "OnAHeater",
      "platform": "PC",
      "rankScore": 26000,
      "rankLadderPosition": 120,
      "rankTier": "Apex Predator",
      "isPredator": true,
      "rpDelta": 480,
      "matchCount": 6,
      "rpHistory": [
        80,
        95,
        60,
        120,
        75,
        50
      ],
      "isInMatch": true
    }
  ],
  "losers": [
    {
      "uid": "2222222222",
      "username": "RoughNight",
      "platform": "PC",
      "rankScore": 24500,
      "rankLadderPosition": 300,
      "rankTier": "Apex Predator",
      "isPredator": true,
      "rpDelta": -260,
      "matchCount": 5,
      "rpHistory": [
        -60,
        -40,
        -80,
        -30,
        -50
      ],
      "isInMatch": false
    }
  ],
  "windowHours": 1
}

GET/api/v1/predator-cutoff

Get the current Apex Predator RP cutoff for a platform, plus Predator and Master player counts. Lightweight alternative to pulling a full leaderboard page. Predator is the top 750 above Master, so until 750 players hold a slot the cutoff is the 16,000 Master floor — ladderFull tells you which of the two you are reading.

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "predatorThresholdRp": 25000,
  "predatorCount": 750,
  "masterCount": 5000,
  "predatorSlots": 750,
  "ladderFull": true,
  "generatedAt": "2026-03-17T12:00:00Z"
}

GET/api/v1/map-rotation

Get the current and upcoming ranked map rotation. Maps cycle in a fixed order on 4.5 hour slots.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/map-rotation" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "current": {
    "map": "E-District",
    "startedAt": "2026-03-17T09:30:00Z",
    "endsAt": "2026-03-17T14:00:00Z",
    "remainingSeconds": 7200
  },
  "upcoming": [
    {
      "map": "Storm Point",
      "startsAt": "2026-03-17T14:00:00Z",
      "endsAt": "2026-03-17T18:30:00Z"
    },
    {
      "map": "World's Edge",
      "startsAt": "2026-03-17T18:30:00Z",
      "endsAt": "2026-03-17T23:00:00Z"
    }
  ],
  "rotation": [
    "World's Edge",
    "E-District",
    "Storm Point"
  ],
  "slotDurationHours": 4.5
}

GET/api/v1/stats

Get overall platform statistics. Returns aggregate counts of tracked, banned, and active players.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalTrackedPlayers": 15000,
  "masterPlusPlayers": 5000,
  "bannedPlayers": 1250,
  "activePlayers": 13750
}

GET/api/v1/stats/rank-distribution

Get the rank tier distribution for a platform, from Apex Predator down to Rookie IV. Note: this covers the tracked population, which skews heavily toward Predator/Master.

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/rank-distribution?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "population": 14000,
  "notSeenThisSplit": 3200,
  "predatorCount": 750,
  "masterCount": 5000,
  "predatorThresholdRp": 25000,
  "medianRp": 17200,
  "p90Rp": 24000,
  "maxRp": 35000,
  "buckets": [
    {
      "label": "Apex Predator",
      "tier": "Predator",
      "minRp": 25000,
      "count": 750,
      "percent": 5.4
    },
    {
      "label": "Master",
      "tier": "Master",
      "minRp": 16000,
      "count": 5000,
      "percent": 35.7
    }
  ],
  "generatedAt": "2026-03-17T12:00:00Z"
}

GET/api/v1/lobbies/recent

Get recently-finished Predator lobbies — which tracked Predators were in the same match, with confirmed squads.

Parameters

limitquery · integer: Maximum number of lobbies. Range: 1-50, default: 12

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/lobbies/recent?limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "lobbies": [
    {
      "lobbyId": "PC:1774000000",
      "platform": "PC",
      "startedAt": "2026-03-17T11:00:00Z",
      "endedAt": "2026-03-17T11:22:00Z",
      "trackedPredatorCount": 6,
      "confirmedSquadCount": 2,
      "members": [
        {
          "uid": "1111111111",
          "username": "TopPredator",
          "platform": "PC",
          "ladderPosition": 1,
          "rankScore": 35000,
          "rankTier": "Apex Predator",
          "currentLegend": "Bangalore",
          "isPartyFull": true,
          "isJoinable": false,
          "squadId": "S1",
          "anchorApproximate": false
        }
      ]
    }
  ]
}

GET/api/v1/predator-cutoff/history

The daily Predator RP cutoff for the current split on every platform.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff/history" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platforms": [
    {
      "platform": "PC",
      "currentCutoff": 18500,
      "cutoff24hAgo": 18500,
      "delta24h": 140,
      "predatorCount": 125,
      "masterCount": 125,
      "predatorSlots": 750,
      "ladderFull": false
    }
  ],
  "history": [
    {
      "day": "2026-10-16T12:00:00Z",
      "platform": "PC",
      "cutoff": 18500
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/predator-cutoff/forecast

Projected end-of-split Predator cutoff, with a P10–P90 band, the projected path and last split's backtest.

Parameters

platformquery · string: PC, PS4, X1 or Switch. Defaults to every platform.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff/forecast?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "split": 2,
  "platforms": [
    {
      "platform": "PC",
      "method": "trend + seasonal",
      "dayIndex": 14,
      "current": 23880,
      "p10": 22900,
      "p50": 24100,
      "p90": 25400,
      "priorSplits": 3,
      "actual": [
        24100
      ],
      "path": [
        {
          "dayIndex": 14,
          "p10": 22900,
          "p50": 24100,
          "p90": 25400
        }
      ],
      "analogs": [
        {
          "splitId": "29-2",
          "displayName": "ExamplePlayer",
          "projected": 24350
        }
      ],
      "backtest": {
        "splitId": "29-2",
        "displayName": "ExamplePlayer",
        "lengthDays": 42,
        "actualFinal": 24350,
        "method": "trend + seasonal",
        "priorSplits": 3,
        "checkpointDay": 14,
        "checkpointError": -120,
        "maxErrorFromCheckpoint": 350,
        "bandHitRate": 12.5,
        "points": [
          {
            "dayIndex": 14,
            "cutoff": 18500,
            "p10": 22900,
            "p50": 24100,
            "p90": 25400
          }
        ]
      }
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/predator-cutoff/splits

Every recent split's daily Predator cutoff and Master+ count, per platform.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff/splits" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splits": [
    {
      "splitId": "29-2",
      "displayName": "ExamplePlayer",
      "start": "2026-10-01T00:00:00Z",
      "lengthDays": 42,
      "isCurrent": false,
      "platforms": [
        {
          "platform": "PC",
          "cutoff": [
            18500
          ],
          "masterPlus": [
            18500
          ]
        }
      ]
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/splits

Every ranked split with stored rank data, newest first. The current split is flagged isCurrent.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/splits" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splits": [
    {
      "splitId": "29-2",
      "displayName": "ExamplePlayer",
      "from": "2026-10-01T00:00:00Z",
      "to": "2026-10-16T00:00:00Z",
      "playerDays": 21,
      "isCurrent": false
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/stats/rank-distribution/history

Rank tier distribution for a past split, per platform, from each player's last recorded day in that split.

Parameters

splitIdquery · stringRequired: Split id from /api/v1/splits, such as 29-1

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/rank-distribution/history?splitId=29-1" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splitId": "29-2",
  "displayName": "ExamplePlayer",
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-16T00:00:00Z",
  "totalPlayers": 125,
  "platforms": [
    {
      "platform": "PC",
      "totalPlayers": 125,
      "predatorThresholdRp": 18500,
      "buckets": [
        {
          "label": "Master",
          "tier": "Master",
          "minRp": 18500,
          "count": 125,
          "percent": 12.5
        }
      ]
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

Meta5Legend and weapon meta, and who displays which badges and trackers.

GET/api/v1/meta/legends

Legend pick rates and average RP change across the tracked population, with the previous window for comparison.

Parameters

tierquery · string: Rank tier when the match was played: Rookie, Bronze, Silver, Gold, Platinum, Diamond, Master, Predator or ALL. Default: ALL
mapquery · string: Map name, such as E-District. Defaults to every map.
daysquery · integer: Window length in days. Range: 1-90, default: 30

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/meta/legends?tier=Master&days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "tier": "Master",
  "map": "E-District",
  "days": 30,
  "totalSample": 125,
  "prevTotalSample": 125,
  "legends": [
    {
      "legend": "Wraith",
      "characterId": 1,
      "share": 12.5,
      "sampleCount": 125,
      "avgRpChange": 42,
      "prevShare": 12.5,
      "prevSampleCount": 125,
      "shareDelta": 0.8,
      "tierShares": [
        {
          "tier": "Master",
          "share": 12.5,
          "sampleCount": 125
        }
      ]
    }
  ],
  "maps": [
    {
      "key": "Master",
      "sampleCount": 125,
      "share": 12.5
    }
  ],
  "tiers": [
    {
      "key": "Master",
      "sampleCount": 125,
      "share": 12.5
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z",
  "methodology": "How the figure is computed."
}

GET/api/v1/meta/weapons

Weapon mastery across the tracked population.

Parameters

platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
tierquery · string: The holder's current rank tier, Rookie to Predator, or ALL. Default: ALL

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/meta/weapons?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "weapons": [
    {
      "weaponSaid": "r301",
      "playersTracking": 14000,
      "trackShare": 12.5,
      "kills": {
        "players": 5000,
        "median": 17200,
        "p90": 25400,
        "total": 125
      },
      "damage": {
        "players": 5000,
        "median": 17200,
        "p90": 25400,
        "total": 125
      }
    }
  ],
  "trackedPlayers": 14000,
  "platform": "PC",
  "tier": "Master",
  "methodology": "How the figure is computed.",
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/cosmetics

The most-displayed badges and trackers across tracked players' current banners, per platform and overall.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/cosmetics" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platforms": [
    {
      "platform": "PC",
      "population": 14000,
      "badges": [
        {
          "id": 1,
          "players": 5000,
          "share": 12.5,
          "predators": 750,
          "masterPlus": 18500
        }
      ],
      "trackers": [
        {
          "id": 1,
          "players": 5000,
          "share": 12.5,
          "predators": 750,
          "masterPlus": 18500
        }
      ],
      "predatorPopulation": 18500
    }
  ],
  "totalPopulation": 125,
  "methodology": "How the figure is computed.",
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/cosmetics/badge-holders

Tracked players who have displayed a badge, best-ranked first: Predators by ladder position, then everyone else by RP.

Parameters

badgeIdquery · integerRequired: The badge id, from /api/v1/cosmetics or /player/{uid}/banner
platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
qquery · string: Find one player by name or UID
tierquery · string: Rookie to Predator, or ALL. Default: ALL
minPositionquery · integer: Lowest Predator ladder slot to include (1-750). Implies tier=Predator.
maxPositionquery · integer: Highest Predator ladder slot to include (1-750). Implies tier=Predator.
equippedOnlyquery · boolean: Only players displaying the badge right now. Default: false
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/cosmetics/badge-holders?badgeId=245450466&platform=PC&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "badgeId": 1,
  "totalCount": 125,
  "page": 1,
  "pageSize": 1,
  "platform": "PC",
  "query": "ExamplePlayer",
  "tier": "Master",
  "minPosition": 342,
  "maxPosition": 342,
  "equippedOnly": false,
  "summary": {
    "totalHolders": 125,
    "equippedNow": 812,
    "predators": 750,
    "masterPlus": 18500,
    "bestLadderPosition": 18500,
    "firstSeenAt": "2026-10-16T12:00:00Z",
    "lastSeenAt": "2026-10-16T12:00:00Z",
    "tiers": [
      {
        "tier": "Master",
        "players": 5000,
        "equippedNow": 812
      }
    ]
  },
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "rankScore": 18500,
      "ladderPosition": 18500,
      "rankTier": "Master",
      "isPredator": false,
      "accountLevel": 125,
      "tierValue": 3,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z",
      "equippedNow": 812
    }
  ]
}

GET/api/v1/cosmetics/tracker-holders

Who displays a banner tracker, ranked by the value on their banner.

Parameters

trackerIdquery · integerRequired: The tracker id, from /api/v1/cosmetics or /player/{uid}/banner
platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
qquery · string: Find one player by name or UID
tierquery · string: Rookie to Predator, or ALL. Default: ALL
minValuequery · integer: Lowest tracker value to include
maxValuequery · integer: Highest tracker value to include
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/cosmetics/tracker-holders?trackerId=1487125419&platform=PC&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "trackerId": 1,
  "totalCount": 125,
  "page": 1,
  "pageSize": 1,
  "platform": "PC",
  "query": "ExamplePlayer",
  "tier": "Master",
  "minValue": 0,
  "maxValue": 25000,
  "summary": {
    "totalHolders": 125,
    "equippedNow": 812,
    "predators": 750,
    "masterPlus": 18500,
    "topValue": 98000,
    "firstSeenAt": "2026-10-16T12:00:00Z",
    "lastSeenAt": "2026-10-16T12:00:00Z",
    "bands": [
      {
        "bucket": 0,
        "lowerBound": 22900,
        "upperBound": 25400,
        "players": 5000,
        "equippedNow": 812,
        "minValue": 0,
        "maxValue": 25000
      }
    ]
  },
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "value": 4210,
      "valueRank": 342,
      "rankScore": 18500,
      "ladderPosition": 18500,
      "rankTier": "Master",
      "isPredator": false,
      "accountLevel": 125,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z",
      "equippedNow": 812
    }
  ]
}

Status3Game server, service and outage status.

GET/api/v1/status/servers

Get live Apex game server status from the most recent probe cycle, grouped by category.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/status/servers" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "checkedAt": "2026-03-17T12:00:00Z",
  "categories": [
    {
      "category": "EA Login",
      "endpoints": [
        {
          "category": "EA Login",
          "name": "US East",
          "host": "example.ea.com",
          "port": 443,
          "status": "up",
          "latencyMs": 23
        }
      ]
    }
  ]
}

GET/api/v1/status/services

EA and Apex service status, with 90-day uptime history per service.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/status/services" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "services": [
    {
      "name": "ExamplePlayer",
      "status": "operational",
      "uptime": 99.95,
      "responseTimeMs": 48,
      "history": [
        "operational"
      ],
      "historyDetails": [
        {
          "status": "operational",
          "durationMinutes": 95,
          "reasons": [
            null
          ]
        }
      ]
    }
  ],
  "checkedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/status/outage-reports

A 24-hour summary of community outage reports: totals by category and platform, 30-minute buckets and the latest reports. Contains no IP-derived data.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/status/outage-reports" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "last24h": 38,
  "perCategory": {},
  "perPlatform": {},
  "buckets": [
    {
      "bucketStart": "2026-10-16T12:00:00Z",
      "count": 125
    }
  ],
  "recent": [
    {
      "category": "EA Login",
      "platform": "PC",
      "createdAt": "2026-10-16T12:00:00Z"
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

Recaps3End-of-split summaries, overall and per player.

GET/api/v1/recaps

Ranked splits that have a recap, newest first.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/recaps" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splits": [
    {
      "slug": "29-2",
      "splitId": "29-2",
      "season": 29,
      "split": 2,
      "displayName": "ExamplePlayer",
      "from": "2026-10-01T00:00:00Z",
      "to": "2026-10-16T00:00:00Z",
      "endsAt": "2026-10-16T12:00:00Z",
      "isCurrent": false
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/recaps/{slug}

One split's recap: daily Predator cutoffs, end-of-split Predator and Master counts, and the bans detected during the split.

Parameters

slugpath · stringRequired: Split slug from /api/v1/recaps, such as 29-2

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/recaps/29-2" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "settled": false,
  "headline": {
    "players": 5000,
    "games": 14,
    "predators": 750,
    "masters": 5000,
    "bans": 125,
    "unbans": 125,
    "waves": 3,
    "fallenPredators": 57,
    "topLegend": "Wraith"
  },
  "platforms": [
    {
      "platform": "PC",
      "players": 5000,
      "games": 14,
      "predators": 750,
      "masters": 5000,
      "finalCutoff": 18500,
      "peakCutoff": 18500,
      "ladderFull": false,
      "topRp": 18500,
      "cutoffCurve": [
        {
          "day": "2026-10-16T12:00:00Z",
          "cutoff": 18500
        }
      ],
      "climbers": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "netRp": 18500,
          "finalRp": 18500,
          "finalLadderPosition": 18500,
          "peakRp": 18500,
          "games": 14,
          "daysPlayed": 21
        }
      ],
      "numberOne": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "days": 30,
          "from": "2026-10-01T00:00:00Z",
          "to": "2026-10-16T00:00:00Z",
          "bestPosition": 342,
          "finalRp": 18500
        }
      ],
      "topTen": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "days": 30,
          "from": "2026-10-01T00:00:00Z",
          "to": "2026-10-16T00:00:00Z",
          "bestPosition": 342,
          "finalRp": 18500
        }
      ],
      "bans": 125,
      "unbans": 125,
      "fallenPredatorCount": 125,
      "fallenPredators": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "platform": "PC",
          "bannedAt": "2026-10-16T12:00:00Z",
          "rankScoreAtBan": 18500,
          "ladderPositionAtBan": 18500,
          "permanent": false
        }
      ],
      "legends": [
        {
          "legend": "Wraith",
          "matches": 14,
          "share": 12.5
        }
      ]
    }
  ],
  "legends": [
    {
      "legend": "Wraith",
      "matches": 14,
      "share": 12.5
    }
  ],
  "banDays": [
    {
      "day": "2026-10-16T12:00:00Z",
      "platform": "PC",
      "bans": 125
    }
  ],
  "waves": [
    {
      "id": 1,
      "startedAt": "2026-10-16T12:00:00Z",
      "endedAt": "2026-10-16T12:00:00Z",
      "banCount": 125,
      "peakHourlyRate": 12.5,
      "baselineHourlyRate": 12.5,
      "durationMinutes": 95,
      "mix": {
        "platform": "PC",
        "tier": "Master",
        "count": 125,
        "ranked": 342
      }
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z",
  "slug": "29-2",
  "splitId": "29-2",
  "season": 29,
  "split": 2,
  "displayName": "ExamplePlayer",
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-16T00:00:00Z",
  "endsAt": "2026-10-16T12:00:00Z",
  "isCurrent": false
}

GET/api/v1/recaps/{slug}/players/{uid}

One player's split: peak RP and tier, best Predator slot, and closing RP and ladder position. Follows the player's privacy setting.

Parameters

slugpath · stringRequired: Split slug from /api/v1/recaps, such as 29-2
uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/recaps/29-2/players/1234567890?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "slug": "29-2",
  "splitId": "29-2",
  "season": 29,
  "split": 2,
  "displayName": "ExamplePlayer",
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-16T00:00:00Z",
  "isCurrent": false,
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "platform": "PC",
  "allowIndexing": false,
  "peakRp": 18500,
  "peakTier": "Predator",
  "bestLadderPosition": 18500,
  "finalRp": 18500,
  "finalLadderPosition": 18500,
  "finalTier": "Predator",
  "daysPlayed": 21,
  "games": 14,
  "wins": 8,
  "netRp": 18500,
  "bestDay": {
    "date": "2026-10-16T12:00:00Z",
    "netRp": 18500,
    "games": 14
  },
  "rankUps": [
    {
      "at": "2026-10-16T12:00:00Z",
      "from": "2026-10-01T00:00:00Z",
      "to": "2026-10-16T00:00:00Z",
      "rp": 18500,
      "ladderPosition": 18500
    }
  ],
  "topLegend": "Wraith",
  "journey": [
    {
      "date": "2026-10-16T12:00:00Z",
      "rp": 18500,
      "ladderPosition": 18500,
      "splitId": "29-2",
      "netRp": 18500,
      "games": 14
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

Atom Feeds

Prefer to subscribe instead of polling? These Atom feeds need no API key and work in any feed reader or Discord webhook bridge. Each refreshes within about a minute.

Feed	Contents
/api/bans/feed.xml	The 50 most recent ban detections across every platform.
/api/players/{uid}/feed.xml	One player's ban and unban events. Also linked from each profile page.
/api/waves/feed.xml	Detected ban waves, one entry per wave.
/api/leaderboard/cutoff/feed.xml?platform=PC	One platform's Predator cutoff: an entry each time it moves 250 RP or more. platform is PC, PS4, X1 or Switch.
/api/status/feed.xml	Tracker and Apex service status updates.

Try it

Pick an endpoint, fill in its parameters and copy a ready-to-run request. Your key never leaves this page — it only goes into the command you copy. The response shown is the documented example, not a live call.

EndpointAPI key

Get detailed player information by UID. Returns rank, ban status, online status, current legend, and more.

uidpath · stringRequiredplatformquery · string

Send the key as

Request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

{
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "platform": "PC",
  "rankScore": 18500,
  "rankTier": "Master",
  "rankLadderPosition": 342,
  "isMasterOrAbove": true,
  "isPredator": false,
  "isBanned": false,
  "banReason": null,
  "bannedAt": null,
  "unbannedAt": null,
  "banCount": 0,
  "currentLegend": "Wraith",
  "accountLevel": 500,
  "isOnline": true,
  "isInMatch": false,
  "lastUpdated": "2026-03-17T12:00:00Z"
}

NextChat Commands →Something unclear?Tell us and we'll fix the wording →

Loading…

Developers

API Docs

Access Apex Legends ban data, ban waves, player stats and match history, leaderboards, the Predator cutoff and its forecast, legend and weapon meta, split recaps, and server status via our REST API.

8 sections

The short version

1Plain REST over HTTPS: 55 endpoints under api.apexbantracker.com/api/v1, all returning JSON with UTC ISO 8601 timestamps.
2Every request carries your bp_ key — the Authorization: Bearer header is recommended; X-Api-Key or the api_key query parameter also work.
3Monthly plans from $5. Every plan includes every endpoint; the tiers differ only in rate limits.
4Over a limit you get 429 with a Retry-After header. The Atom feeds need no key and don't count against a plan.

Quick Start

Get up and running in under a minute. Here's how to make your first API call:

Base URL

HTTPS

https://api.apexbantracker.com/api/v1

1
Get your API key
Sign up and subscribe to a plan from the developer dashboard. You'll receive an API key starting with bp_.

Make a request

Pass your API key in the Authorization header:

Shell

curl -X GET "https://api.apexbantracker.com/api/v1/stats" \
  -H "Authorization: Bearer bp_your_api_key_here"

Parse the JSON response

JSON

{
  "totalTrackedPlayers": 15000,
  "masterPlusPlayers": 5000,
  "bannedPlayers": 1250,
  "activePlayers": 13750
}

Code examples

Python

import requests

API_KEY = "bp_your_api_key_here"
BASE_URL = "https://api.apexbantracker.com/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Get player by UID
response = requests.get(f"{BASE_URL}/player/1234567890", headers=headers)
player = response.json()
print(f"{player['username']} - Rank: {player['rankTier']} ({player['rankScore']} RP)")

# Search for players
response = requests.get(f"{BASE_URL}/players/search", params={"q": "ninja", "limit": 5}, headers=headers)
for p in response.json():
    print(f"  {p['username']} ({p['platform']}) - {p['rankScore']} RP")

JavaScript / Node.js

const API_KEY = "bp_your_api_key_here";
const BASE_URL = "https://api.apexbantracker.com/api/v1";

const headers = { Authorization: `Bearer ${API_KEY}` };

// Get player by UID
const playerRes = await fetch(`${BASE_URL}/player/1234567890?platform=PC`, { headers });
const player = await playerRes.json();
console.log(`${player.username} - ${player.rankTier} (${player.rankScore} RP)`);

// Get recent bans
const bansRes = await fetch(`${BASE_URL}/bans/recent?limit=5`, { headers });
const bans = await bansRes.json();
bans.forEach(b => console.log(`${b.username} banned at ${b.bannedAt}`));

C# / .NET

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer bp_your_api_key_here");

var baseUrl = "https://api.apexbantracker.com/api/v1";

// Get player by UID
var playerJson = await client.GetStringAsync($"{baseUrl}/player/1234567890?platform=PC");
Console.WriteLine(playerJson);

// Get leaderboard
var leaderboardJson = await client.GetStringAsync($"{baseUrl}/leaderboard?platform=PC&pageSize=10");
Console.WriteLine(leaderboardJson);

Authentication

All API requests require a valid API key. You can pass your key using any of these methods:

Authorization headerRecommended

Authorization: Bearer bp_your_api_key_here

X-Api-Key header

X-Api-Key: bp_your_api_key_here

Query parameter

GET /api/v1/stats?api_key=bp_your_api_key_here

Query parameter auth is less secure, as the key may appear in server logs. Use a header when possible.

Plans & Pricing

Basic

$5/month

For hobbyist developers and small projects

2 requests/second
1,000 requests/day
30,000 requests/month
All endpoints included

PlusPopular

$10/month

For professional developers and growing applications

5 requests/second
10,000 requests/day
300,000 requests/month
All endpoints included

Enterprise

$15/month

For large-scale applications and commercial use

15 requests/second
100,000 requests/day
3,000,000 requests/month
All endpoints included

Ban, unban and ban-wave Discord alerts are free with any account — no API plan required. Need higher limits or a custom agreement? Get in touch.

Rate Limits

Plan	Price	Per second	Per day	Per month
Basic	$5/mo	2 req/s	1,000 req/day	30,000 req/month
Plus	$10/mo	5 req/s	10,000 req/day	300,000 req/month
Enterprise	$15/mo	15 req/s	100,000 req/day	3,000,000 req/month

To subscribe, create a key from the developer dashboard — see Plans & Pricing above.

Response headers

Every API response includes these headers so you can track your usage:

HTTP

X-RateLimit-Plan: plus
X-RateLimit-Limit-Day: 10000
X-RateLimit-Limit-Second: 5
X-RateLimit-Remaining-Day: 9874
X-RateLimit-Remaining-Month: 287412

X-RateLimit-Plan carries the plan's id: basic, plus or enterprise. The remaining counts reset at 00:00 UTC each day and on the 1st of each month.

Error Codes

All errors return a JSON object with error and code fields:

JSON

{
  "error": "Daily request limit of 1000 exceeded",
  "code": "DAILY_LIMIT"
}

HTTP status	Code	Description
401	MISSING_API_KEY	No API key was provided in the request
400	INVALID_PLATFORM	The platform parameter is not one of PC, PS4, X1 or Switch
401	INVALID_KEY	The API key does not exist or is malformed
403	KEY_SUSPENDED	API key is suspended due to a payment issue
403	KEY_EXPIRED	The subscription associated with this key has expired
403	KEY_REVOKED	This API key has been revoked by the owner
403	IP_NOT_ALLOWED	The request came from an IP address outside this key's allowlist
403	ACCOUNT_DISABLED	The account that owns this key is disabled
429	RATE_LIMITED	You have exceeded your plan's per-second request limit
429	DAILY_LIMIT	You have exceeded your plan's daily request limit
429	MONTHLY_LIMIT	You have exceeded your plan's monthly request limit
404	-	The requested resource was not found, or the player's detail data is not public
500	-	An unexpected server error occurred

Endpoints

All endpoints return JSON. Timestamps are in UTC ISO 8601 format.

55 of 55

Players16Profiles, search, match and RP history, splits, analytics and banners.

GET/api/v1/player/{uid}

Get detailed player information by UID. Returns rank, ban status, online status, current legend, and more.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "platform": "PC",
  "rankScore": 18500,
  "rankTier": "Master",
  "rankLadderPosition": 342,
  "isMasterOrAbove": true,
  "isPredator": false,
  "isBanned": false,
  "banReason": null,
  "bannedAt": null,
  "unbannedAt": null,
  "banCount": 0,
  "currentLegend": "Wraith",
  "accountLevel": 500,
  "isOnline": true,
  "isInMatch": false,
  "lastUpdated": "2026-03-17T12:00:00Z"
}

GET/api/v1/players/search

Search for players by username. Returns a list of matching players sorted by rank score (highest first). Players who set their profile to private are not included.

Parameters

qquery · stringRequired: Username to search for (case-insensitive, partial match)
limitquery · integer: Maximum number of results to return. Range: 1-100, default: 25

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/players/search?q=ninja&limit=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "1234567890",
    "username": "ExamplePlayer",
    "platform": "PC",
    "rankScore": 18500,
    "ladderPosition": 342,
    "isBanned": false,
    "isOnline": true,
    "currentLegend": "Wraith",
    "accountLevel": 500
  }
]

GET/api/v1/player/{uid}/ban-history

Get the ban/unban event history for a specific player. Returns up to 50 events, newest first.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/ban-history" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "eventType": "BAN",
    "eventDate": "2026-02-15T08:30:00Z",
    "reason": null,
    "rankScoreAtBan": 22000,
    "ladderPositionAtBan": 45,
    "banSeconds": 0
  },
  {
    "eventType": "UNBAN",
    "eventDate": "2026-03-01T14:00:00Z",
    "reason": null,
    "rankScoreAtBan": null,
    "ladderPositionAtBan": null,
    "banSeconds": 0
  }
]

GET/api/v1/player/{uid}/matches

Get a player's ranked match history with RP changes, legends used, and kill estimates. Newest first. Returns 404 for players whose profile visibility is limited or private, matching the website.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
limitquery · integer: Maximum number of results. Range: 1-100, default: 50
offsetquery · integer: Number of results to skip for pagination. Default: 0

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/matches?limit=25" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "rpChange": 120,
    "finalRp": 18620,
    "finalLadderPosition": 339,
    "legend": "Wraith",
    "matchTime": "2026-03-17T11:20:00Z",
    "estimatedKills": {
      "minKills": 3,
      "maxKills": 6,
      "mostLikelyKills": 4,
      "mostLikelyPlacement": 2,
      "minPlacement": 2,
      "maxPlacement": 3,
      "confidence": "medium"
    }
  }
]

GET/api/v1/player/{uid}/rp-history

Get a player's all-time RP curve, downsampled to one point per UTC day (the day's final match). Returns 404 for players whose profile visibility is limited or private, matching the website.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/rp-history" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "date": "2026-03-16T00:00:00Z",
    "rp": 18500,
    "ladderPosition": 342
  },
  {
    "date": "2026-03-17T00:00:00Z",
    "rp": 18620,
    "ladderPosition": 339
  }
]

GET/api/v1/player/{uid}/aliases

Get the full username (alias) history recorded for a player, newest first. Returns 404 for players whose profile visibility is limited or private, matching the website.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/aliases" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "username": "CurrentName",
    "firstSeenAt": "2026-02-01T10:00:00Z",
    "lastSeenAt": "2026-03-17T12:00:00Z"
  },
  {
    "username": "OldName",
    "firstSeenAt": "2025-11-12T08:00:00Z",
    "lastSeenAt": "2026-01-31T22:00:00Z"
  }
]

GET/api/v1/players/batch

Look up to 60 players at once by name or UID: rank, ban status and ban count for each, in request order, plus the platform's Predator cutoff. Private profiles come back as private with no data.

Parameters

namesquery · stringRequired: Comma-separated names or UIDs, up to 60
platformquery · string: Platform to resolve names on: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/players/batch?names=ExamplePlayer,AnotherPlayer&platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "predatorCutoff": 18500,
  "truncated": false,
  "results": [
    {
      "query": "ExamplePlayer",
      "status": "up",
      "player": {
        "uid": "1234567890",
        "platform": "PC",
        "username": "ExamplePlayer",
        "rankTier": "Master",
        "rankScore": 18500,
        "ladderPosition": 18500,
        "isPredator": false,
        "banState": "banned",
        "banCount": 125,
        "visibility": "public",
        "allowIndexing": false,
        "linkedAccounts": 125,
        "lastActiveAt": "2026-10-16T12:00:00Z",
        "isOnline": false,
        "isInMatch": false,
        "currentLegend": "Wraith",
        "accountLevel": 125,
        "playedCurrentSplit": false,
        "predBubble": false,
        "openCase": false,
        "linkedToSuspect": false
      }
    }
  ]
}

POST/api/v1/players/batch

The same lookup as GET /api/v1/players/batch, taking a JSON body instead of a query string. Use it for long lists.

Parameters

namesbody · string[]Required: Names or UIDs, up to 60
platformbody · string: Platform to resolve names on: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X POST "https://api.apexbantracker.com/api/v1/players/batch" \
  -H "Authorization: Bearer bp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"names":["ExamplePlayer","AnotherPlayer"],"platform":"PC"}'

Example response

JSON

{
  "platform": "PC",
  "predatorCutoff": 18500,
  "truncated": false,
  "results": [
    {
      "query": "ExamplePlayer",
      "status": "up",
      "player": {
        "uid": "1234567890",
        "platform": "PC",
        "username": "ExamplePlayer",
        "rankTier": "Master",
        "rankScore": 18500,
        "ladderPosition": 18500,
        "isPredator": false,
        "banState": "banned",
        "banCount": 125,
        "visibility": "public",
        "allowIndexing": false,
        "linkedAccounts": 125,
        "lastActiveAt": "2026-10-16T12:00:00Z",
        "isOnline": false,
        "isInMatch": false,
        "currentLegend": "Wraith",
        "accountLevel": 125,
        "playedCurrentSplit": false,
        "predBubble": false,
        "openCase": false,
        "linkedToSuspect": false
      }
    }
  ]
}

GET/api/v1/players/top

Top tracked players by one career stat. Banned accounts and duplicate linked accounts are excluded.

Parameters

statquery · string: kills, damage, wins, matches or level. Default: kills
platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50
qquery · string: Find one player by name or UID within the ranking

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/players/top?stat=kills&platform=PC&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalCount": 125,
  "page": 1,
  "pageSize": 1,
  "stat": "kills",
  "platform": "PC",
  "query": "ExamplePlayer",
  "players": [
    {
      "rank": 342,
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "rankScore": 18500,
      "rankTier": "Master",
      "isPredator": false,
      "accountLevel": 125,
      "value": 4210,
      "mainLegend": "Wraith"
    }
  ]
}

GET/api/v1/player/{uid}/splits

The ranked splits a player has matches in, newest first. Use a split id with rp-progression and analytics.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/splits" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "splitId": "29-2",
    "firstSeen": "2026-10-16T12:00:00Z",
    "lastSeen": "2026-10-16T12:00:00Z",
    "isCurrent": false,
    "displayName": "ExamplePlayer"
  }
]

GET/api/v1/player/{uid}/rp-progression

Match-by-match RP for one ranked split, including past splits. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
splitquery · stringRequired: Split id from /player/{uid}/splits, such as 29-2
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/rp-progression?split=29-2" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "timestamp": "2026-10-16T12:00:00Z",
    "rp": 18500,
    "rpChange": 18500,
    "isAnomaly": false,
    "legend": "Wraith",
    "ladderPosition": 18500,
    "estimatedKills": {
      "expectedScoreUnits": 18500,
      "expectedKillsAssists": 4.1,
      "minKills": 3,
      "maxKills": 6,
      "mostLikelyKills": 4,
      "mostLikelyPlacement": 2,
      "minPlacement": 1,
      "maxPlacement": 3,
      "confidence": "none"
    },
    "rpBreakdown": {
      "entryCost": -35,
      "earned": 410,
      "placementRp": 18500,
      "killRp": 18500,
      "basis": "entry"
    },
    "splitId": "29-2",
    "accountLevelAtMatch": 125,
    "map": "E-District",
    "matchDurationSeconds": 1260,
    "observedPlacement": 2,
    "confirmedSquadmates": [
      {
        "uid": "1234567890",
        "username": "ExamplePlayer",
        "platform": "PC"
      }
    ]
  }
]

GET/api/v1/player/{uid}/analytics

A player's analytics: legend usage, RP gained and lost, and per-match RP progression, for a rolling window or one split. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
daysquery · integer: Rolling window in days when no split is given. Default: 30
splitquery · string: Split id from /player/{uid}/splits. Scopes every figure to that split.
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/analytics?split=29-2" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "playerUid": "1234567890",
  "playerName": "ExamplePlayer",
  "currentRp": 18500,
  "currentLadderPosition": 18500,
  "rankTier": "Master",
  "isBanned": false,
  "matchCount": 125,
  "totalRpChange": 18500,
  "totalRpGained": 18500,
  "totalRpLost": 18500,
  "averageRpPerMatch": 18500,
  "bestMatchRp": 18500,
  "worstMatchRp": 18500,
  "analysisPeriodDays": 30,
  "splitId": "29-2",
  "isCurrentSplit": false,
  "estimatedTotalKills": 125,
  "estimatedKillsMatchCount": 125,
  "estimatedKillsPerMatch": 3.2,
  "estimatedScoreUnitsPerMatch": 18500,
  "predatorThresholdRp": 18500,
  "characterUsage": [
    {
      "legend": "Wraith",
      "matchCount": 125,
      "totalRpChange": 18500,
      "averageRpChange": 18500
    }
  ],
  "rpProgression": [
    {
      "timestamp": "2026-10-16T12:00:00Z",
      "rp": 18500,
      "rpChange": 18500,
      "isAnomaly": false,
      "legend": "Wraith",
      "ladderPosition": 18500,
      "estimatedKills": {
        "expectedScoreUnits": 18500,
        "expectedKillsAssists": 4.1,
        "minKills": 3,
        "maxKills": 6,
        "mostLikelyKills": 4,
        "mostLikelyPlacement": 2,
        "minPlacement": 1,
        "maxPlacement": 3,
        "confidence": "none"
      },
      "rpBreakdown": {
        "entryCost": -35,
        "earned": 410,
        "placementRp": 18500,
        "killRp": 18500,
        "basis": "entry"
      },
      "splitId": "29-2",
      "accountLevelAtMatch": 125,
      "map": "E-District",
      "matchDurationSeconds": 1260,
      "observedPlacement": 2,
      "confirmedSquadmates": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "platform": "PC"
        }
      ]
    }
  ],
  "confirmedSquadmatesHistory": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "platform": "PC",
      "games": 14,
      "totalRpChange": 18500,
      "wins": 8,
      "losses": 6,
      "rankTier": "Master",
      "rankScore": 18500,
      "isBanned": false,
      "bannedAt": "2026-10-16T12:00:00Z",
      "firstPlayedWithAt": "2026-10-16T12:00:00Z",
      "lastPlayedWithAt": "2026-10-16T12:00:00Z",
      "affinityScore": 18500
    }
  ],
  "percentiles": {
    "populationSize": 14000,
    "rp": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeKills": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeDamage": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeWins": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "lifetimeMatches": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    },
    "accountLevel": {
      "value": 4210,
      "rank": 342,
      "topPercent": 12.5
    }
  }
}

GET/api/v1/player/{uid}/tracker-percentiles

Where each of a player's banner trackers ranks among players on the same platform with the same legend and tracker. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/tracker-percentiles" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "characterId": 1,
    "trackerStatId": 1,
    "value": 4210,
    "rank": 342,
    "topPercent": 12.5,
    "population": 14000
  }
]

GET/api/v1/player/{uid}/banner

Every badge and tracker seen on a player's banner, with when each was first and last seen. Returns 404 for players whose profile visibility is limited or private.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890/banner" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "playerUid": "1234567890",
  "badges": [
    {
      "badgeId": 1,
      "tierValue": 3,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z"
    }
  ],
  "trackers": [
    {
      "characterId": 1,
      "trackerStatId": 1,
      "lastValue": 4210,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z"
    }
  ]
}

GET/api/v1/streamers

Streamers who have linked their Apex account and are listed in the site's streamer directory, with live status.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/streamers" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "streamers": [
    {
      "uid": "1234567890",
      "platform": "PC",
      "username": "ExamplePlayer",
      "rankScore": 18500,
      "ladderPosition": 18500,
      "accountLevel": 125,
      "isPredator": false,
      "twitchUsername": "ExamplePlayer",
      "youtubeChannel": null,
      "xHandle": null,
      "country": "US",
      "inputMethod": "mnk",
      "isLive": false,
      "streamTitle": "Ranked grind",
      "streamGame": "Apex Legends",
      "viewerCount": 125,
      "liveSince": "2026-10-16T12:00:00Z",
      "isBanned": false,
      "rpThisStream": 18500,
      "currentLegend": "Wraith",
      "lastLiveAt": "2026-10-16T12:00:00Z"
    }
  ],
  "liveCount": 125,
  "totalCount": 125
}

Bans16The ban list, ban waves, ban rate, Fallen Predators and ban statistics.

GET/api/v1/bans

Get all currently banned players with pagination.

Parameters

pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Number of results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans?page=1&pageSize=25" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalCount": 1250,
  "page": 1,
  "pageSize": 25,
  "totalPages": 50,
  "players": [
    {
      "uid": "9876543210",
      "username": "BannedPlayer",
      "platform": "PC",
      "rankScore": 20000,
      "rankTier": "Master",
      "rankLadderPosition": -1,
      "isBanned": true,
      "bannedAt": "2026-03-10T14:00:00Z",
      "banCount": 2,
      "lastUpdated": "2026-03-17T08:00:00Z"
    }
  ]
}

GET/api/v1/bans/recent

Get the most recently banned players. Useful for monitoring new bans as they happen.

Parameters

limitquery · integer: Maximum number of results. Range: 1-100, default: 10

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/recent?limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "9876543210",
    "username": "RecentlyBanned",
    "platform": "PC",
    "rankScore": 19000,
    "rankTier": "Master",
    "rankLadderPosition": -1,
    "bannedAt": "2026-03-17T10:00:00Z",
    "banCount": 1,
    "lastUpdated": "2026-03-17T10:05:00Z"
  }
]

GET/api/v1/bans/recent-unbans

Get players who were recently unbanned. Useful for tracking false-positive ban reversals.

Parameters

limitquery · integer: Maximum number of results. Range: 1-100, default: 10

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/recent-unbans?limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "5555555555",
    "username": "RecentlyUnbanned",
    "platform": "PC",
    "rankScore": 17000,
    "rankTier": "Master",
    "rankLadderPosition": 200,
    "unbannedAt": "2026-03-16T20:00:00Z",
    "banCount": 1,
    "lastUpdated": "2026-03-16T20:05:00Z"
  }
]

GET/api/v1/bans/search

Search within banned players by username or UID.

Parameters

qquery · stringRequired: Username or UID to search for (case-insensitive, partial match)
limitquery · integer: Maximum number of results. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/search?q=cheater&limit=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "9876543210",
    "username": "BannedPlayer",
    "platform": "PC",
    "rankScore": 20000,
    "rankTier": "Master",
    "rankLadderPosition": -1,
    "isBanned": true,
    "bannedAt": "2026-03-10T14:00:00Z",
    "banCount": 2,
    "lastUpdated": "2026-03-17T08:00:00Z"
  }
]

GET/api/v1/bans/most-banned

Get the players with the highest all-time ban counts (repeat offenders with 2+ bans), sorted by ban count.

Parameters

limitquery · integer: Maximum number of results. Range: 1-50, default: 10

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/most-banned?limit=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "uid": "9876543210",
    "username": "RepeatOffender",
    "tag": null,
    "platform": "PC",
    "rankTier": "ApexPredator",
    "rankScore": 22000,
    "isPredator": true,
    "isBanned": true,
    "banCount": 5,
    "lastBannedAt": "2026-03-15T09:00:00Z"
  }
]

GET/api/v1/stats/ban-stats

Get detailed aggregated ban statistics: current vs all-time bans, Predator vs Master splits, temp bans, repeat offenders, and last-24h activity.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-stats" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalBans": 1250,
  "allTimeBans": 3400,
  "predatorBans": 400,
  "masterBans": 700,
  "otherBans": 150,
  "tempBans": 120,
  "repeatOffenders": 90,
  "last24Hours": 35
}

GET/api/v1/bans/waves

Detected ban waves, newest first, plus the wave in progress if there is one. A wave is a stretch where the hourly ban rate runs well above its 7-day baseline.

Parameters

daysquery · integer: How far back to look, in days. Range: 1-365, default: 90

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/waves?days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "activeWave": {
    "id": 1,
    "startedAt": "2026-10-16T12:00:00Z",
    "endedAt": null,
    "banCount": 125,
    "peakHourlyRate": 12.5,
    "baselineHourlyRate": 12.5,
    "durationMinutes": 95,
    "mix": {
      "platform": "PC",
      "tier": "Master",
      "count": 125,
      "ranked": 342
    }
  },
  "waves": [
    {
      "id": 1,
      "startedAt": "2026-10-16T12:00:00Z",
      "endedAt": "2026-10-16T12:00:00Z",
      "banCount": 125,
      "peakHourlyRate": 12.5,
      "baselineHourlyRate": 12.5,
      "durationMinutes": 95,
      "mix": {
        "platform": "PC",
        "tier": "Master",
        "count": 125,
        "ranked": 342
      }
    }
  ]
}

GET/api/v1/bans/waves/{id}

One ban wave with its full roster: every ban detected inside the wave window, with each account's name, platform, RP and ladder position at the ban.

Parameters

idpath · integerRequired: The wave id, from /api/v1/bans/waves

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/waves/42" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "wave": {
    "id": 1,
    "startedAt": "2026-10-16T12:00:00Z",
    "endedAt": "2026-10-16T12:00:00Z",
    "banCount": 125,
    "peakHourlyRate": 12.5,
    "baselineHourlyRate": 12.5,
    "durationMinutes": 95,
    "mix": {
      "platform": "PC",
      "tier": "Master",
      "count": 125,
      "ranked": 342
    }
  },
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "platform": "PC",
      "eventDate": "2026-10-16T12:00:00Z",
      "rankScoreAtBan": 18500,
      "ladderPositionAtBan": 18500,
      "banSeconds": 125,
      "confidenceLevel": "medium",
      "inferredRegion": "NA"
    }
  ]
}

GET/api/v1/bans/rate

Hourly ban counts over a rolling window, with the 7-day baseline rate, anti-cheat update markers and any waves overlapping the window.

Parameters

hoursquery · integer: Window length in hours. Range: 6-168, default: 48

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/rate?hours=48" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "buckets": [
    {
      "hourStart": "2026-10-16T11:00:00Z",
      "count": 125
    }
  ],
  "baselineHourly": 3.4,
  "eacUpdates": [
    {
      "detectedAt": "2026-10-16T12:00:00Z",
      "changeNumber": "1",
      "system": "EA Login"
    }
  ],
  "waves": [
    {
      "id": 1,
      "startedAt": "2026-10-16T12:00:00Z",
      "endedAt": "2026-10-16T12:00:00Z",
      "banCount": 125,
      "peakHourlyRate": 12.5,
      "baselineHourlyRate": 12.5,
      "durationMinutes": 95,
      "mix": {
        "platform": "PC",
        "tier": "Master",
        "count": 125,
        "ranked": 342
      }
    }
  ],
  "activeWave": {
    "id": 1,
    "startedAt": "2026-10-16T12:00:00Z",
    "endedAt": "2026-10-16T12:00:00Z",
    "banCount": 125,
    "peakHourlyRate": 12.5,
    "baselineHourlyRate": 12.5,
    "durationMinutes": 95,
    "mix": {
      "platform": "PC",
      "tier": "Master",
      "count": 125,
      "ranked": 342
    }
  }
}

GET/api/v1/bans/daily-top

The biggest names banned on each UTC day of the window, highest RP at ban first.

Parameters

daysquery · integer: Window length in days. Range: 1-90, default: 90

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/daily-top?days=7" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "days": [
    {
      "date": "2026-10-16T12:00:00Z",
      "players": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "platform": "PC",
          "eventDate": "2026-10-16T12:00:00Z",
          "rankScoreAtBan": 18500,
          "ladderPositionAtBan": 18500,
          "banSeconds": 125,
          "confidenceLevel": "medium",
          "inferredRegion": "NA"
        }
      ]
    }
  ]
}

GET/api/v1/bans/fallen-predators

Banned players who hold Predator season badges, with their per-season badge shelf and totals.

Parameters

platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
seasonquery · integer: Only players with a Predator badge from this ranked season
sortquery · string: recent (newest ban first), placement (best ladder slot first), season (newest season first) or badges (most Predator badges first). Default: recent
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-96, default: 48

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/fallen-predators?platform=PC&sort=recent&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalPlayers": 125,
  "totalBadges": 125,
  "topTenPlayers": 10,
  "latestBanAt": "2026-10-16T12:00:00Z",
  "seasons": [
    {
      "season": 29,
      "players": 5000,
      "bestPlacement": 1
    }
  ],
  "platform": "PC",
  "season": 29,
  "sort": "recent",
  "page": 1,
  "pageSize": 1,
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "accountLevel": 125,
      "bannedAt": "2026-10-16T12:00:00Z",
      "banSeconds": 125,
      "rankScoreAtBan": 18500,
      "ladderPositionAtBan": 18500,
      "bestPlacement": 1,
      "newestSeason": 29,
      "badges": [
        {
          "badgeId": 1,
          "season": 29,
          "ladderPosition": 18500,
          "tierValue": 3,
          "firstSeenAt": "2026-10-16T12:00:00Z",
          "lastSeenAt": "2026-10-16T12:00:00Z"
        }
      ]
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/bans/fallen-predators/{uid}

One banned player's Predator season badges. Returns 404 when the player isn't currently banned or holds no Predator badge.

Parameters

uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/fallen-predators/1234567890" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "tag": null,
  "platform": "PC",
  "accountLevel": 125,
  "bannedAt": "2026-10-16T12:00:00Z",
  "banSeconds": 125,
  "rankScoreAtBan": 18500,
  "ladderPositionAtBan": 18500,
  "bestPlacement": 1,
  "newestSeason": 29,
  "badges": [
    {
      "badgeId": 1,
      "season": 29,
      "ladderPosition": 18500,
      "tierValue": 3,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z"
    }
  ]
}

GET/api/v1/bans/official-reconciliation

Official EA/Respawn ban announcements next to the number of bans this tracker detected in each announced window.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/bans/official-reconciliation" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "announcements": [
    {
      "id": 1,
      "announcedAt": "2026-10-16T12:00:00Z",
      "windowStart": "2026-10-15T12:00:00Z",
      "windowEnd": "2026-10-16T12:00:00Z",
      "bannedCount": 125,
      "rpRemoved": 18500,
      "source": "tracker",
      "sourceUrl": "https://example.com/",
      "notes": null,
      "trackerDetections": 41
    }
  ]
}

GET/api/v1/stats/ban-trends

Daily ban and unban counts.

Parameters

daysquery · integer: Window length in days. Range: 1-365, default: 90

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-trends?days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "date": "2026-10-16T12:00:00Z",
    "bans": 125,
    "unbans": 125
  }
]

GET/api/v1/stats/ban-timeline

Daily ban and unban counts as a chart-ready time series.

Parameters

daysquery · integer: Window length in days. Range: 1-365, default: 90. Values outside the range return 400.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-timeline?days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

[
  {
    "date": "2026-10-16T12:00:00Z",
    "bans": 125,
    "unbans": 125,
    "predatorBans": 125
  }
]

GET/api/v1/stats/ban-breakdown

Current bans broken down by platform, rank tier and ban type.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/ban-breakdown" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platformBreakdown": [
    {
      "label": "Master",
      "count": 125
    }
  ],
  "rankBreakdown": [
    {
      "label": "Master",
      "count": 125
    }
  ],
  "banTypeBreakdown": [
    {
      "label": "Master",
      "count": 125
    }
  ]
}

Ranked12Leaderboards, the Predator cutoff and its forecast, rank distribution, map rotation and lobbies.

GET/api/v1/leaderboard

Get the ranked leaderboard for a specific platform. Returns top players sorted by ladder position.

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/leaderboard?platform=PC&page=1&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "totalCount": 750,
  "page": 1,
  "pageSize": 10,
  "predatorThresholdRp": 25000,
  "predatorCount": 750,
  "masterCount": 5000,
  "players": [
    {
      "uid": "1111111111",
      "username": "TopPredator",
      "platform": "PC",
      "rankScore": 35000,
      "rankTier": "Apex Predator",
      "rankLadderPosition": 1,
      "currentLegend": "Bangalore",
      "isOnline": false,
      "isInMatch": false,
      "accountLevel": 500,
      "lastUpdated": "2026-03-17T11:30:00Z"
    }
  ]
}

GET/api/v1/leaderboard/movers

Get the biggest RP gainers and losers over a rolling window, aggregated from recent matches.

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC
windowHoursquery · integer: Rolling window in hours. Range: 1-24, default: 1
limitquery · integer: Maximum gainers/losers each. Range: 1-50, default: 5

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/leaderboard/movers?platform=PC&windowHours=1&limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "gainers": [
    {
      "uid": "1111111111",
      "username": "OnAHeater",
      "platform": "PC",
      "rankScore": 26000,
      "rankLadderPosition": 120,
      "rankTier": "Apex Predator",
      "isPredator": true,
      "rpDelta": 480,
      "matchCount": 6,
      "rpHistory": [
        80,
        95,
        60,
        120,
        75,
        50
      ],
      "isInMatch": true
    }
  ],
  "losers": [
    {
      "uid": "2222222222",
      "username": "RoughNight",
      "platform": "PC",
      "rankScore": 24500,
      "rankLadderPosition": 300,
      "rankTier": "Apex Predator",
      "isPredator": true,
      "rpDelta": -260,
      "matchCount": 5,
      "rpHistory": [
        -60,
        -40,
        -80,
        -30,
        -50
      ],
      "isInMatch": false
    }
  ],
  "windowHours": 1
}

GET/api/v1/predator-cutoff

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "predatorThresholdRp": 25000,
  "predatorCount": 750,
  "masterCount": 5000,
  "predatorSlots": 750,
  "ladderFull": true,
  "generatedAt": "2026-03-17T12:00:00Z"
}

GET/api/v1/map-rotation

Get the current and upcoming ranked map rotation. Maps cycle in a fixed order on 4.5 hour slots.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/map-rotation" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "current": {
    "map": "E-District",
    "startedAt": "2026-03-17T09:30:00Z",
    "endsAt": "2026-03-17T14:00:00Z",
    "remainingSeconds": 7200
  },
  "upcoming": [
    {
      "map": "Storm Point",
      "startsAt": "2026-03-17T14:00:00Z",
      "endsAt": "2026-03-17T18:30:00Z"
    },
    {
      "map": "World's Edge",
      "startsAt": "2026-03-17T18:30:00Z",
      "endsAt": "2026-03-17T23:00:00Z"
    }
  ],
  "rotation": [
    "World's Edge",
    "E-District",
    "Storm Point"
  ],
  "slotDurationHours": 4.5
}

GET/api/v1/stats

Get overall platform statistics. Returns aggregate counts of tracked, banned, and active players.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "totalTrackedPlayers": 15000,
  "masterPlusPlayers": 5000,
  "bannedPlayers": 1250,
  "activePlayers": 13750
}

GET/api/v1/stats/rank-distribution

Get the rank tier distribution for a platform, from Apex Predator down to Rookie IV. Note: this covers the tracked population, which skews heavily toward Predator/Master.

Parameters

platformquery · string: Platform to query: PC, PS4, X1, or Switch (case-insensitive; any other value returns 400). Default: PC

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/rank-distribution?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platform": "PC",
  "population": 14000,
  "notSeenThisSplit": 3200,
  "predatorCount": 750,
  "masterCount": 5000,
  "predatorThresholdRp": 25000,
  "medianRp": 17200,
  "p90Rp": 24000,
  "maxRp": 35000,
  "buckets": [
    {
      "label": "Apex Predator",
      "tier": "Predator",
      "minRp": 25000,
      "count": 750,
      "percent": 5.4
    },
    {
      "label": "Master",
      "tier": "Master",
      "minRp": 16000,
      "count": 5000,
      "percent": 35.7
    }
  ],
  "generatedAt": "2026-03-17T12:00:00Z"
}

GET/api/v1/lobbies/recent

Get recently-finished Predator lobbies — which tracked Predators were in the same match, with confirmed squads.

Parameters

limitquery · integer: Maximum number of lobbies. Range: 1-50, default: 12

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/lobbies/recent?limit=5" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "lobbies": [
    {
      "lobbyId": "PC:1774000000",
      "platform": "PC",
      "startedAt": "2026-03-17T11:00:00Z",
      "endedAt": "2026-03-17T11:22:00Z",
      "trackedPredatorCount": 6,
      "confirmedSquadCount": 2,
      "members": [
        {
          "uid": "1111111111",
          "username": "TopPredator",
          "platform": "PC",
          "ladderPosition": 1,
          "rankScore": 35000,
          "rankTier": "Apex Predator",
          "currentLegend": "Bangalore",
          "isPartyFull": true,
          "isJoinable": false,
          "squadId": "S1",
          "anchorApproximate": false
        }
      ]
    }
  ]
}

GET/api/v1/predator-cutoff/history

The daily Predator RP cutoff for the current split on every platform.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff/history" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platforms": [
    {
      "platform": "PC",
      "currentCutoff": 18500,
      "cutoff24hAgo": 18500,
      "delta24h": 140,
      "predatorCount": 125,
      "masterCount": 125,
      "predatorSlots": 750,
      "ladderFull": false
    }
  ],
  "history": [
    {
      "day": "2026-10-16T12:00:00Z",
      "platform": "PC",
      "cutoff": 18500
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/predator-cutoff/forecast

Projected end-of-split Predator cutoff, with a P10–P90 band, the projected path and last split's backtest.

Parameters

platformquery · string: PC, PS4, X1 or Switch. Defaults to every platform.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff/forecast?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "split": 2,
  "platforms": [
    {
      "platform": "PC",
      "method": "trend + seasonal",
      "dayIndex": 14,
      "current": 23880,
      "p10": 22900,
      "p50": 24100,
      "p90": 25400,
      "priorSplits": 3,
      "actual": [
        24100
      ],
      "path": [
        {
          "dayIndex": 14,
          "p10": 22900,
          "p50": 24100,
          "p90": 25400
        }
      ],
      "analogs": [
        {
          "splitId": "29-2",
          "displayName": "ExamplePlayer",
          "projected": 24350
        }
      ],
      "backtest": {
        "splitId": "29-2",
        "displayName": "ExamplePlayer",
        "lengthDays": 42,
        "actualFinal": 24350,
        "method": "trend + seasonal",
        "priorSplits": 3,
        "checkpointDay": 14,
        "checkpointError": -120,
        "maxErrorFromCheckpoint": 350,
        "bandHitRate": 12.5,
        "points": [
          {
            "dayIndex": 14,
            "cutoff": 18500,
            "p10": 22900,
            "p50": 24100,
            "p90": 25400
          }
        ]
      }
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/predator-cutoff/splits

Every recent split's daily Predator cutoff and Master+ count, per platform.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/predator-cutoff/splits" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splits": [
    {
      "splitId": "29-2",
      "displayName": "ExamplePlayer",
      "start": "2026-10-01T00:00:00Z",
      "lengthDays": 42,
      "isCurrent": false,
      "platforms": [
        {
          "platform": "PC",
          "cutoff": [
            18500
          ],
          "masterPlus": [
            18500
          ]
        }
      ]
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/splits

Every ranked split with stored rank data, newest first. The current split is flagged isCurrent.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/splits" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splits": [
    {
      "splitId": "29-2",
      "displayName": "ExamplePlayer",
      "from": "2026-10-01T00:00:00Z",
      "to": "2026-10-16T00:00:00Z",
      "playerDays": 21,
      "isCurrent": false
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/stats/rank-distribution/history

Rank tier distribution for a past split, per platform, from each player's last recorded day in that split.

Parameters

splitIdquery · stringRequired: Split id from /api/v1/splits, such as 29-1

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/stats/rank-distribution/history?splitId=29-1" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splitId": "29-2",
  "displayName": "ExamplePlayer",
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-16T00:00:00Z",
  "totalPlayers": 125,
  "platforms": [
    {
      "platform": "PC",
      "totalPlayers": 125,
      "predatorThresholdRp": 18500,
      "buckets": [
        {
          "label": "Master",
          "tier": "Master",
          "minRp": 18500,
          "count": 125,
          "percent": 12.5
        }
      ]
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

Meta5Legend and weapon meta, and who displays which badges and trackers.

GET/api/v1/meta/legends

Legend pick rates and average RP change across the tracked population, with the previous window for comparison.

Parameters

tierquery · string: Rank tier when the match was played: Rookie, Bronze, Silver, Gold, Platinum, Diamond, Master, Predator or ALL. Default: ALL
mapquery · string: Map name, such as E-District. Defaults to every map.
daysquery · integer: Window length in days. Range: 1-90, default: 30

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/meta/legends?tier=Master&days=30" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "tier": "Master",
  "map": "E-District",
  "days": 30,
  "totalSample": 125,
  "prevTotalSample": 125,
  "legends": [
    {
      "legend": "Wraith",
      "characterId": 1,
      "share": 12.5,
      "sampleCount": 125,
      "avgRpChange": 42,
      "prevShare": 12.5,
      "prevSampleCount": 125,
      "shareDelta": 0.8,
      "tierShares": [
        {
          "tier": "Master",
          "share": 12.5,
          "sampleCount": 125
        }
      ]
    }
  ],
  "maps": [
    {
      "key": "Master",
      "sampleCount": 125,
      "share": 12.5
    }
  ],
  "tiers": [
    {
      "key": "Master",
      "sampleCount": 125,
      "share": 12.5
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z",
  "methodology": "How the figure is computed."
}

GET/api/v1/meta/weapons

Weapon mastery across the tracked population.

Parameters

platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
tierquery · string: The holder's current rank tier, Rookie to Predator, or ALL. Default: ALL

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/meta/weapons?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "weapons": [
    {
      "weaponSaid": "r301",
      "playersTracking": 14000,
      "trackShare": 12.5,
      "kills": {
        "players": 5000,
        "median": 17200,
        "p90": 25400,
        "total": 125
      },
      "damage": {
        "players": 5000,
        "median": 17200,
        "p90": 25400,
        "total": 125
      }
    }
  ],
  "trackedPlayers": 14000,
  "platform": "PC",
  "tier": "Master",
  "methodology": "How the figure is computed.",
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/cosmetics

The most-displayed badges and trackers across tracked players' current banners, per platform and overall.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/cosmetics" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "platforms": [
    {
      "platform": "PC",
      "population": 14000,
      "badges": [
        {
          "id": 1,
          "players": 5000,
          "share": 12.5,
          "predators": 750,
          "masterPlus": 18500
        }
      ],
      "trackers": [
        {
          "id": 1,
          "players": 5000,
          "share": 12.5,
          "predators": 750,
          "masterPlus": 18500
        }
      ],
      "predatorPopulation": 18500
    }
  ],
  "totalPopulation": 125,
  "methodology": "How the figure is computed.",
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/cosmetics/badge-holders

Tracked players who have displayed a badge, best-ranked first: Predators by ladder position, then everyone else by RP.

Parameters

badgeIdquery · integerRequired: The badge id, from /api/v1/cosmetics or /player/{uid}/banner
platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
qquery · string: Find one player by name or UID
tierquery · string: Rookie to Predator, or ALL. Default: ALL
minPositionquery · integer: Lowest Predator ladder slot to include (1-750). Implies tier=Predator.
maxPositionquery · integer: Highest Predator ladder slot to include (1-750). Implies tier=Predator.
equippedOnlyquery · boolean: Only players displaying the badge right now. Default: false
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/cosmetics/badge-holders?badgeId=245450466&platform=PC&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "badgeId": 1,
  "totalCount": 125,
  "page": 1,
  "pageSize": 1,
  "platform": "PC",
  "query": "ExamplePlayer",
  "tier": "Master",
  "minPosition": 342,
  "maxPosition": 342,
  "equippedOnly": false,
  "summary": {
    "totalHolders": 125,
    "equippedNow": 812,
    "predators": 750,
    "masterPlus": 18500,
    "bestLadderPosition": 18500,
    "firstSeenAt": "2026-10-16T12:00:00Z",
    "lastSeenAt": "2026-10-16T12:00:00Z",
    "tiers": [
      {
        "tier": "Master",
        "players": 5000,
        "equippedNow": 812
      }
    ]
  },
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "rankScore": 18500,
      "ladderPosition": 18500,
      "rankTier": "Master",
      "isPredator": false,
      "accountLevel": 125,
      "tierValue": 3,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z",
      "equippedNow": 812
    }
  ]
}

GET/api/v1/cosmetics/tracker-holders

Who displays a banner tracker, ranked by the value on their banner.

Parameters

trackerIdquery · integerRequired: The tracker id, from /api/v1/cosmetics or /player/{uid}/banner
platformquery · string: Platform: PC, PS4, X1, Switch or ALL (case-insensitive). Default: ALL
qquery · string: Find one player by name or UID
tierquery · string: Rookie to Predator, or ALL. Default: ALL
minValuequery · integer: Lowest tracker value to include
maxValuequery · integer: Highest tracker value to include
pagequery · integer: Page number, starting from 1. Default: 1
pageSizequery · integer: Results per page. Range: 1-100, default: 50

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/cosmetics/tracker-holders?trackerId=1487125419&platform=PC&pageSize=10" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "trackerId": 1,
  "totalCount": 125,
  "page": 1,
  "pageSize": 1,
  "platform": "PC",
  "query": "ExamplePlayer",
  "tier": "Master",
  "minValue": 0,
  "maxValue": 25000,
  "summary": {
    "totalHolders": 125,
    "equippedNow": 812,
    "predators": 750,
    "masterPlus": 18500,
    "topValue": 98000,
    "firstSeenAt": "2026-10-16T12:00:00Z",
    "lastSeenAt": "2026-10-16T12:00:00Z",
    "bands": [
      {
        "bucket": 0,
        "lowerBound": 22900,
        "upperBound": 25400,
        "players": 5000,
        "equippedNow": 812,
        "minValue": 0,
        "maxValue": 25000
      }
    ]
  },
  "players": [
    {
      "uid": "1234567890",
      "username": "ExamplePlayer",
      "tag": null,
      "platform": "PC",
      "value": 4210,
      "valueRank": 342,
      "rankScore": 18500,
      "ladderPosition": 18500,
      "rankTier": "Master",
      "isPredator": false,
      "accountLevel": 125,
      "firstSeenAt": "2026-10-16T12:00:00Z",
      "lastSeenAt": "2026-10-16T12:00:00Z",
      "equippedNow": 812
    }
  ]
}

Status3Game server, service and outage status.

GET/api/v1/status/servers

Get live Apex game server status from the most recent probe cycle, grouped by category.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/status/servers" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "checkedAt": "2026-03-17T12:00:00Z",
  "categories": [
    {
      "category": "EA Login",
      "endpoints": [
        {
          "category": "EA Login",
          "name": "US East",
          "host": "example.ea.com",
          "port": 443,
          "status": "up",
          "latencyMs": 23
        }
      ]
    }
  ]
}

GET/api/v1/status/services

EA and Apex service status, with 90-day uptime history per service.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/status/services" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "services": [
    {
      "name": "ExamplePlayer",
      "status": "operational",
      "uptime": 99.95,
      "responseTimeMs": 48,
      "history": [
        "operational"
      ],
      "historyDetails": [
        {
          "status": "operational",
          "durationMinutes": 95,
          "reasons": [
            null
          ]
        }
      ]
    }
  ],
  "checkedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/status/outage-reports

A 24-hour summary of community outage reports: totals by category and platform, 30-minute buckets and the latest reports. Contains no IP-derived data.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/status/outage-reports" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "last24h": 38,
  "perCategory": {},
  "perPlatform": {},
  "buckets": [
    {
      "bucketStart": "2026-10-16T12:00:00Z",
      "count": 125
    }
  ],
  "recent": [
    {
      "category": "EA Login",
      "platform": "PC",
      "createdAt": "2026-10-16T12:00:00Z"
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

Recaps3End-of-split summaries, overall and per player.

GET/api/v1/recaps

Ranked splits that have a recap, newest first.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/recaps" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "splits": [
    {
      "slug": "29-2",
      "splitId": "29-2",
      "season": 29,
      "split": 2,
      "displayName": "ExamplePlayer",
      "from": "2026-10-01T00:00:00Z",
      "to": "2026-10-16T00:00:00Z",
      "endsAt": "2026-10-16T12:00:00Z",
      "isCurrent": false
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

GET/api/v1/recaps/{slug}

One split's recap: daily Predator cutoffs, end-of-split Predator and Master counts, and the bans detected during the split.

Parameters

slugpath · stringRequired: Split slug from /api/v1/recaps, such as 29-2

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/recaps/29-2" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "settled": false,
  "headline": {
    "players": 5000,
    "games": 14,
    "predators": 750,
    "masters": 5000,
    "bans": 125,
    "unbans": 125,
    "waves": 3,
    "fallenPredators": 57,
    "topLegend": "Wraith"
  },
  "platforms": [
    {
      "platform": "PC",
      "players": 5000,
      "games": 14,
      "predators": 750,
      "masters": 5000,
      "finalCutoff": 18500,
      "peakCutoff": 18500,
      "ladderFull": false,
      "topRp": 18500,
      "cutoffCurve": [
        {
          "day": "2026-10-16T12:00:00Z",
          "cutoff": 18500
        }
      ],
      "climbers": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "netRp": 18500,
          "finalRp": 18500,
          "finalLadderPosition": 18500,
          "peakRp": 18500,
          "games": 14,
          "daysPlayed": 21
        }
      ],
      "numberOne": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "days": 30,
          "from": "2026-10-01T00:00:00Z",
          "to": "2026-10-16T00:00:00Z",
          "bestPosition": 342,
          "finalRp": 18500
        }
      ],
      "topTen": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "days": 30,
          "from": "2026-10-01T00:00:00Z",
          "to": "2026-10-16T00:00:00Z",
          "bestPosition": 342,
          "finalRp": 18500
        }
      ],
      "bans": 125,
      "unbans": 125,
      "fallenPredatorCount": 125,
      "fallenPredators": [
        {
          "uid": "1234567890",
          "username": "ExamplePlayer",
          "platform": "PC",
          "bannedAt": "2026-10-16T12:00:00Z",
          "rankScoreAtBan": 18500,
          "ladderPositionAtBan": 18500,
          "permanent": false
        }
      ],
      "legends": [
        {
          "legend": "Wraith",
          "matches": 14,
          "share": 12.5
        }
      ]
    }
  ],
  "legends": [
    {
      "legend": "Wraith",
      "matches": 14,
      "share": 12.5
    }
  ],
  "banDays": [
    {
      "day": "2026-10-16T12:00:00Z",
      "platform": "PC",
      "bans": 125
    }
  ],
  "waves": [
    {
      "id": 1,
      "startedAt": "2026-10-16T12:00:00Z",
      "endedAt": "2026-10-16T12:00:00Z",
      "banCount": 125,
      "peakHourlyRate": 12.5,
      "baselineHourlyRate": 12.5,
      "durationMinutes": 95,
      "mix": {
        "platform": "PC",
        "tier": "Master",
        "count": 125,
        "ranked": 342
      }
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z",
  "slug": "29-2",
  "splitId": "29-2",
  "season": 29,
  "split": 2,
  "displayName": "ExamplePlayer",
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-16T00:00:00Z",
  "endsAt": "2026-10-16T12:00:00Z",
  "isCurrent": false
}

GET/api/v1/recaps/{slug}/players/{uid}

One player's split: peak RP and tier, best Predator slot, and closing RP and ladder position. Follows the player's privacy setting.

Parameters

slugpath · stringRequired: Split slug from /api/v1/recaps, such as 29-2
uidpath · stringRequired: The player's unique identifier (numeric UID)
platformquery · string: Platform filter: PC, PS4, X1 or Switch. Defaults to all platforms.

Example request

curl -X GET "https://api.apexbantracker.com/api/v1/recaps/29-2/players/1234567890?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

JSON

{
  "slug": "29-2",
  "splitId": "29-2",
  "season": 29,
  "split": 2,
  "displayName": "ExamplePlayer",
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-16T00:00:00Z",
  "isCurrent": false,
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "platform": "PC",
  "allowIndexing": false,
  "peakRp": 18500,
  "peakTier": "Predator",
  "bestLadderPosition": 18500,
  "finalRp": 18500,
  "finalLadderPosition": 18500,
  "finalTier": "Predator",
  "daysPlayed": 21,
  "games": 14,
  "wins": 8,
  "netRp": 18500,
  "bestDay": {
    "date": "2026-10-16T12:00:00Z",
    "netRp": 18500,
    "games": 14
  },
  "rankUps": [
    {
      "at": "2026-10-16T12:00:00Z",
      "from": "2026-10-01T00:00:00Z",
      "to": "2026-10-16T00:00:00Z",
      "rp": 18500,
      "ladderPosition": 18500
    }
  ],
  "topLegend": "Wraith",
  "journey": [
    {
      "date": "2026-10-16T12:00:00Z",
      "rp": 18500,
      "ladderPosition": 18500,
      "splitId": "29-2",
      "netRp": 18500,
      "games": 14
    }
  ],
  "generatedAt": "2026-10-16T12:00:00Z"
}

Atom Feeds

Prefer to subscribe instead of polling? These Atom feeds need no API key and work in any feed reader or Discord webhook bridge. Each refreshes within about a minute.

Feed	Contents
/api/bans/feed.xml	The 50 most recent ban detections across every platform.
/api/players/{uid}/feed.xml	One player's ban and unban events. Also linked from each profile page.
/api/waves/feed.xml	Detected ban waves, one entry per wave.
/api/leaderboard/cutoff/feed.xml?platform=PC	One platform's Predator cutoff: an entry each time it moves 250 RP or more. platform is PC, PS4, X1 or Switch.
/api/status/feed.xml	Tracker and Apex service status updates.

Try it

EndpointAPI key

Get detailed player information by UID. Returns rank, ban status, online status, current legend, and more.

uidpath · stringRequiredplatformquery · string

Send the key as

Request

curl -X GET "https://api.apexbantracker.com/api/v1/player/1234567890?platform=PC" \
  -H "Authorization: Bearer bp_your_api_key_here"

Example response

{
  "uid": "1234567890",
  "username": "ExamplePlayer",
  "platform": "PC",
  "rankScore": 18500,
  "rankTier": "Master",
  "rankLadderPosition": 342,
  "isMasterOrAbove": true,
  "isPredator": false,
  "isBanned": false,
  "banReason": null,
  "bannedAt": null,
  "unbannedAt": null,
  "banCount": 0,
  "currentLegend": "Wraith",
  "accountLevel": 500,
  "isOnline": true,
  "isInMatch": false,
  "lastUpdated": "2026-03-17T12:00:00Z"
}

NextChat Commands →Something unclear?Tell us and we'll fix the wording →