Forts Tools

API reference

Every read-only JSON endpoint of forts-tools.com: parameters, response fields, statuses, caching and rate limits.

Changed in v2: POST /api/telemetry forts-telemetry/2

POST /api/telemetry now answers a ranked log of any size, in pages. Its schema is forts-telemetry/2; it was forts-telemetry/1.

What changedIn v1 a log with more matches than one answer holds was refused with 422. In v2 it is answered in full, over several pages. New fields: page, pages, next_url, samples.matches[].continued.
What a v1 client must doAccept forts-telemetry/2. While page is less than pages, fetch next_url with GET; stop when page equals pages (next_url is then null). Join the pages as below. A client that reads only the first answer gets only page 1 of a long log.
UnchangedA log of 300 or fewer matches (with ?samples=1, also 6,000 or fewer series points) is answered exactly as in v1 apart from the tag: one page, page: 1, pages: 1, next_url: null.
Further pages/api/telemetry/<job>/<page>, by GET: pages 2 to pages, the same shape as page 1. Nothing is uploaded or decoded again.
Page size300 matches; with ?samples=1, also at most 6,000 series points.
Result lifetime10 min from the first answer, the same as downloads[].url. After that a page answers 410; upload the log again.
Joining the pagesmatches: pages 1 to pages in order, concatenated. samples.matches: the same, except that an entry marked continued: true goes on in the first entry of the next page; append that entry's rows to it. summary, releases, matches_total, rejections, downloads are the same on every page.
Page statuses200: the page. 404: no such page number. 410: the result has expired. 429: the rate limit, shared with the upload, is spent.

Endpoints

EndpointSchema markerSame data as
/api/siteforts-site/1/about
/api/rankingsforts-rankings/1/leaderboard
/api/player-searchforts-player-search/1/player/search
/api/player/<steamid64>forts-player/1/player/<steamid64>
/api/player-namesforts-ranked-names/1/leaderboard
/api/playersforts-players/1/lobbies
/api/liveforts-live/1/live
/api/buildsforts-builds/1/steamcmd
/api/dataforts-data/1/data
POST /api/replayforts-replay/1/workbench
POST /api/versionforts-version/2/version
POST /api/telemetryforts-telemetry/2/telemetry
GET /api/telemetry/<job>/<page>forts-telemetry/2/telemetry

Rules for every endpoint

BodyUTF-8 JSON, one object, keys sorted. Times are UTC, written YYYY-MM-DDTHH:MM:SSZ. SteamIDs are 17-digit strings.
VersioningEvery answer carries schema. Its number moves only on a breaking change; a new field is added without changing it, so a client ignores keys it does not know.
Missing valuesnull means the site holds no value; it is never a measured zero. When an answer is empty or partial, reason says why in English.
RefusalsA refusal by the application is {"ok": false, "error": "…"}, the message in the language of Accept-Language. A refusal by the proxy (429 from a rate limit) is an HTML page with Retry-After.
Browser accessNo CORS headers are sent. fetch() from a page is blocked by the browser before the body is readable. Call this endpoint server-side.
NamesField names, type names and token values are fixed. They are not translated.

/api/site

The site summary: live game release, seasons held, board sizes and the endpoints that are on.

RequestGET https://forts-tools.com/api/site
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-site/1
Same data as/about
AuthenticationNone. No key, no origin allow-list.

Parameters

No parameters.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
sourcestringfalseThe page that shows the same data.
documentationstringfalseThis reference page.
live_releasestringtrueThe live game release.
current_seasonintegertrueThe season the live board is in.
seasonsarray<integer>trueEvery season the site holds, newest first.
standings_captured_utcstringtrueWhen the newest standings were read from the game.
boardsobjecttrueThe current boards; null while the ladder is off or cannot be read.
boards.{board}objectfalseOne board, keyed by its board key (for example 1v1).
boards.{board}.displaystringfalseBoard name as the game shows it.
boards.{board}.totalintegerfalseAccounts on the whole board.
endpointsarray<string>falseThe read-only JSON endpoints that are on, sorted.
standbyobjectfalseCoarse state of the site's standby data path.
standby.statestringfalseA state token: idle, active-failover or unknown.
standby.signal_age_sintegertrueSeconds since the standby path last checked in.
reasonstringtrueWhy the answer is empty or partial, in English; null when it is complete.

Statuses

StatusMeaning
200The answer. A store that cannot be read leaves its fields null and is named in reason.
405A method other than GET or HEAD.
429A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers.
500An unexpected server fault.

Caching and freshness

Cache-Controlno-store, max-age=0
FreshnessRead on every request. standings_captured_utc is the time of the newest standings capture.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/site

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "boards": {
    "1v1": {
      "display": "Season 44 Multiplayer 1v1",
      "total": 3490
    }
  },
  "current_season": 44,
  "documentation": "https://forts-tools.com/api",
  "endpoints": [
    "/api/builds",
    "/api/data",
    "/api/live"
  ],
  "live_release": "Forts 1.39.0 (r22875)",
  "reason": null,
  "schema": "forts-site/1",
  "seasons": [
    44,
    43,
    42
  ],
  "source": "https://forts-tools.com/",
  "standby": {
    "signal_age_s": 94,
    "state": "idle"
  },
  "standings_captured_utc": "2026-11-16T23:35:11Z"
}

/api/rankings

The ranked standings the leaderboard page shows, per board, with each row's recent form and record.

RequestGET https://forts-tools.com/api/rankings
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-rankings/1
Same data as/leaderboard
AuthenticationNone. No key, no origin allow-list.

Parameters

NameInTypeRequiredNotes
seasonqueryintegeroptionalSeason number. Absent: the current season. A season the site holds no data for, or anything but 1 to 3 digits: 404.
modequerystringoptionalOne board key, for example 1v1. Absent: every board. Letters, digits, - and _ only, at most 16 characters, else 400; an unknown board: 404.
limitqueryintegeroptionalRows per board, 1 to 20; default 20, the page's own top rows. Out of range or not a number: 400.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
sourcestringfalseThe page that shows the same data.
definitionstringfalseWhat the figures mean, in English.
seasonintegertrueSeason number.
current_seasonintegertrueThe season the live board is in.
seasonsarray<integer>falseEvery season the site holds, newest first.
archivedbooleanfalseTrue when the answer is a closed season.
captured_utcstringtrueWhen the standings were read from the game.
read_utcstringtrueWhen the site read the capture.
boardsobjectfalseThe boards, keyed by board key.
boards.{board}objectfalseOne board, keyed by its board key (for example 1v1).
boards.{board}.displaystringfalseBoard name as the game shows it.
boards.{board}.totalintegerfalseAccounts on the whole board.
boards.{board}.shownintegerfalseRows the leaderboard page shows for this board.
boards.{board}.rowsarray<object>falseThe rows, top first, at most limit.
boards.{board}.rows[].rankintegerfalsePosition on the board, 1 is the top.
boards.{board}.rows[].namestringtrueName of the account as Steam shows it.
boards.{board}.rows[].scoreintegerfalseBoard score, the Rating column of the leaderboard page.
boards.{board}.rows[].steam_idstringtrueSteamID64 of the account.
boards.{board}.rows[].formarray<boolean>trueRecent decided results, newest first; true is a win.
boards.{board}.rows[].recordobjecttrueThe game's own newest match record for this account.
boards.{board}.rows[].record.ratingintegertrueThe game's internal rating after the match.
boards.{board}.rows[].record.winsintegertrueThe game's season-to-date win counter at the newest match record.
boards.{board}.rows[].record.lossesintegertrueThe game's season-to-date loss counter at the newest match record.
boards.{board}.rows[].record.last_match_utcstringtrueThe game's own time of the last match.
boards.{board}.rows[].record.opponentsarray<object>falseThe game's ring of the last opponents, newest first.
boards.{board}.rows[].record.opponents[].steam_idstringtrueSteamID64 of the account.
boards.{board}.rows[].record.opponents[].namestringtrueName of the account as Steam shows it.
boards.{board}.rows[].record.opponents[].wonbooleantrueTrue won, false lost, null no result held.
moversarray<object>trueThe biggest gains on the current board, at most 5; null for a closed season.
movers[].steam_idstringtrueSteamID64 of the account.
movers[].namestringtrueName of the account as Steam shows it.
movers[].deltaintegertrueScore change over the movers window.
movers[].scoreintegertrueBoard score, the Rating column of the leaderboard page.
movers_hoursintegerfalseLength of the movers window in hours.
limitintegerfalseRows per board this answer applied.
reasonstringtrueWhy the answer is empty or partial, in English; null when it is complete.

Statuses

StatusMeaning
200The answer. An empty or partial answer is still 200 and says why in reason.
400mode has a character other than letters, digits, - and _, or limit is not a number in range.
404season names a season the site holds no data for, or mode names no board.
405A method other than GET or HEAD.
429A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers.
500An unexpected server fault.
503The store cannot be read (same JSON shape, reason set), or the endpoint is switched off.

Caching and freshness

Cache-Controlno-store, max-age=0
FreshnessFollows the ranked ladder sweep; captured_utc says when the standings were read from the game.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/rankings?mode=1v1&limit=2

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "archived": false,
  "boards": {
    "1v1": {
      "display": "Season 44 Multiplayer 1v1",
      "rows": [
        {
          "form": [
            true,
            true,
            true
          ],
          "name": "BaumstaenderTTV",
          "rank": 1,
          "record": {
            "last_match_utc": "2026-11-12T14:34:08Z",
            "losses": 14,
            "opponents": [
              {
                "name": "Chaewon-Biased",
                "steam_id": "76561199567537085",
                "won": true
              }
            ],
            "rating": 1627,
            "wins": 88
          },
          "score": 4714,
          "steam_id": "76561198974455664"
        }
      ],
      "shown": 20,
      "total": 3490
    }
  },
  "captured_utc": "2026-11-16T23:35:11Z",
  "current_season": 44,
  "definition": "Ranked standings as /leaderboard shows them: rank, the name Steam shows, and score (the page's Rating column). form is the row's recent decided results, newest…",
  "limit": 2,
  "movers": [
    {
      "delta": 115,
      "name": "DARKSLAYER",
      "score": 4197,
      "steam_id": "76561199165732689"
    }
  ],
  "movers_hours": 24,
  "read_utc": null,
  "reason": null,
  "schema": "forts-rankings/1",
  "season": 44,
  "seasons": [
    44,
    43,
    42
  ],
  "source": "https://forts-tools.com/leaderboard"
}

/api/player/<steamid64>

One player's recorded ranked matches and statistics, as the player page shows them.

RequestGET https://forts-tools.com/api/player/<steamid64>
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-player/1
Same data as/player/<steamid64>
AuthenticationNone. No key, no origin allow-list.

Parameters

NameInTypeRequiredNotes
steamid64pathstringrequiredThe account's SteamID64, exactly 17 digits; anything else: 404.
matchesqueryintegeroptionalHistory rows returned, 1 to 200; default 50. Out of range or not a number: 400.
seasonqueryintegeroptionalKeep one season's matches. Absent: every season held. A season the site holds nothing for: 404.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
sourcestringfalseThe page that shows the same data.
definitionstringfalseWhat the figures mean, in English.
steam_idstringfalseSteamID64 of the account.
foundbooleanfalseTrue when the site holds a ranked match for this id.
namestringtrueName of the account as Steam shows it.
rankintegertrueCurrent board position; null when off the current standings.
scoreintegertrueCurrent board score; null when off the current standings.
last_played_utcstringtrueTime of the newest recorded match.
winsintegertrueSeason-to-date wins at the newest match; they reset each season.
lossesintegertrueSeason-to-date losses at the newest match; they reset each season.
history_sourcestringtrueWhich records the history was built from.
matches_totalintegerfalseMatches the player page lists (all seasons, or the season asked for).
matches_returnedintegerfalseRows in history.
historyarray<object>falseRecorded matches, newest first.
history[].at_utcstringtrueTime of the match.
history[].wonbooleantrueTrue won, false lost, null no result held.
history[].opponent_steam_idstringtrueSteamID64 of the opponent.
history[].opponent_namestringtrueName of the opponent.
history[].opponent_ratingintegertrueThe opponent's internal rating.
history[].points_deltaintegertrueBoard score change from the match.
history[].ratingintegertrueThe game's internal rating after the match.
history[].mapstringtrueMap, inferred from the ranked lobby log, not recorded by the game.
history[].inferredbooleanfalseTrue where the page marks the match INFERRED.
map_winratesarray<object>trueWins and losses per season and map; null when the store cannot be read.
map_winrates[].seasonstringtrueSeason number.
map_winrates[].mapstringtrueMap name; null when not known.
map_winrates[].winsintegerfalseWins counted.
map_winrates[].lossesintegerfalseLosses counted.
map_winrates[].winrate_pctintegertrueWin rate in whole percent, as the page prints it.
map_winrates[].unjoinedintegerfalseMatches on this map whose result is not held.
namesarray<object>trueNames the account used; null when the store cannot be read.
names[].namestringfalseA name the account used.
names[].first_seenstringtrueDay the site first saw it.
names[].last_seenstringtrueDay the site last saw it.
reasonstringtrueWhy the answer is empty or partial, in English; null when it is complete.
seasonintegertrueThe season asked for; null for every season.
seasonsarray<integer>falseSeasons with a row for this id, newest first.
page_schemastringfalseSchema marker of the player page's assembly these fields come from. Present when found: true.
standingobjecttrueThe standing the page's tiles show. Present when found: true.
standing.seasonintegerfalseSeason number.
standing.modestringfalseBoard key, for example 1v1.
standing.rankintegerfalsePosition on the board, 1 is the top.
standing.scoreintegerfalseBoard score, the Rating column of the leaderboard page.
standing.totalintegerfalseAccounts on the whole board.
standing.fieldintegertrueAccounts counted for top_pct.
standing.top_pctnumbertrueStanding as a percentage from the top of the board.
standing.provisionalbooleanfalseTrue while too few matches count for a settled standing.
standing.gamesintegertrueMatches counted.
standing.basisstringtrueHow the standing was decided.
standing.buildsarray<string>falseGame builds the season's matches were played on.
careerobjecttrueTotals over every season held. Present when found: true.
career.gamesintegerfalseMatches counted.
career.winsintegerfalseWins counted.
career.lossesintegerfalseLosses counted.
career.won_pctnumbertrueWin percentage over the career.
career.seasonsintegerfalseSeasons played.
career.seasons_countedintegerfalseSeasons whose results are counted in the totals.
best_finishobjecttrueBest board position held. Present when found: true.
best_finish.rankintegerfalsePosition on the board, 1 is the top.
best_finish.seasonintegerfalseSeason number.
best_finish.modestringfalseBoard key, for example 1v1.
best_ratingobjecttrueHighest board score held. Present when found: true.
best_rating.scoreintegerfalseBoard score, the Rating column of the leaderboard page.
best_rating.seasonintegerfalseSeason number.
internal_ratingintegertrueThe game's internal rating after the match. Present when found: true.
season_resultsarray<object>falseOne entry per season and board. Present when found: true.
season_results[].seasonintegerfalseSeason number.
season_results[].modestringfalseBoard key, for example 1v1.
season_results[].rankintegertruePosition on the board, 1 is the top.
season_results[].scoreintegertrueBoard score, the Rating column of the leaderboard page.
season_results[].peakintegertrueHighest score reached in the season.
season_results[].winsintegertrueWins counted.
season_results[].lossesintegertrueLosses counted.
season_results[].gamesintegertrueMatches counted.
season_results[].wl_basisstringtrueWhere wins and losses come from.
season_results[].top_pctnumbertrueStanding as a percentage from the top of the board.
season_results[].provisionalbooleanfalseTrue while too few matches count for a settled standing.
season_results[].standing_basisstringtrueHow the standing was decided.
season_results[].buildsarray<string>falseGame builds the season's matches were played on.
streakobjecttrueWin and loss streaks. Present when found: true.
streak.currentobjecttrueThe running streak; null when none.
streak.current.wonbooleanfalseTrue for a win streak, false for a loss streak.
streak.current.nintegerfalseLength of the streak.
streak.longest_wonintegerfalseLongest win streak.
streak.longest_lostintegerfalseLongest loss streak.
form_recentarray<boolean>falseRecent results, newest first; true is a win. Present when found: true.
head_to_headarray<object>falseRecord against each opponent, most games first. Present when found: true.
head_to_head[].steam_idstringfalseSteamID64 of the account.
head_to_head[].namestringtrueName of the account as Steam shows it.
head_to_head[].gamesintegerfalseMatches counted.
head_to_head[].winsintegerfalseWins counted.
head_to_head[].lossesintegerfalseLosses counted.
head_to_head[].last_played_utcstringtrueTime of the last match against this opponent.
activity_weeksarray<object>falseMatches per week, oldest first. Present when found: true.
activity_weeks[].weekstringfalseFirst day of the week.
activity_weeks[].gamesintegerfalseMatches that week.
avatar_urlstringtrueSame-origin path of the account's avatar. Present when found: true.

Statuses

StatusMeaning
200The answer. A well-formed id with no recorded match is 200 with found false, the same answer for every such id.
400matches is not a number in range.
404The path segment is not a 17-digit SteamID64, or season names a season the site holds nothing for.
405A method other than GET or HEAD.
429A rate limit (see Limits), including the crawler limit; the proxy's answer is an HTML page with Retry-After.
500An unexpected server fault.
503The store cannot be read (same JSON shape, reason set), the endpoint is switched off, or every player slot is busy (Retry-After 10).

Caching and freshness

Cache-Controlno-store, max-age=0
Server-side reuseA computed answer is reused for up to 60 s; new data from the stores replaces it at once.
FreshnessFollows the ranked ladder sweep and the match records; last_played_utc is the newest recorded match.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Requests per crawler (proxy)60r/m burst=6Applies when the User-Agent names itself a crawler, shared across every address it uses. Over the burst: 429 with Retry-After 10.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/player/76561198974455664?matches=2

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "activity_weeks": [
    {
      "games": 1,
      "week": "2025-11-24"
    }
  ],
  "avatar_url": "/avatar/h/c956e27fa4112156c39d28ea0ac7b271a7abdd8f?size=medium",
  "best_finish": {
    "mode": "1v1",
    "rank": 1,
    "season": 44
  },
  "best_rating": {
    "score": 4714,
    "season": 44
  },
  "career": {
    "games": 2101,
    "losses": 698,
    "seasons": 25,
    "seasons_counted": 24,
    "wins": 1403,
    "won_pct": 66.8
  },
  "definition": "One player's recorded ranked matches as /player/<id> shows them. rank and score are the current /leaderboard position and Rating, null when this id is not on t…",
  "form_recent": [
    true,
    true,
    true
  ],
  "found": true,
  "head_to_head": [
    {
      "games": 16,
      "last_played_utc": "2026-01-27T17:16:58Z",
      "losses": 11,
      "name": "Julian",
      "steam_id": "76561199507205564",
      "wins": 4
    }
  ],
  "history": [
    {
      "at_utc": "2026-11-12T14:34:08Z",
      "inferred": false,
      "map": "Hillfort",
      "opponent_name": "Chaewon-Biased",
      "opponent_rating": 1483,
      "opponent_steam_id": "76561199567537085",
      "points_delta": 11,
      "rating": 1627,
      "won": true
    }
  ],
  "history_source": "combined",
  "internal_rating": 1627,
  "last_played_utc": "2026-11-12T14:34:08Z",
  "losses": 14,
  "map_winrates": [
    {
      "losses": 5,
      "map": "Split",
      "season": "44",
      "unjoined": 0,
      "winrate_pct": 77,
      "wins": 17
    }
  ],
  "matches_returned": 2,
  "matches_total": 626,
  "name": "BaumstaenderTTV",
  "names": [
    {
      "first_seen": "2026-08-02",
      "last_seen": "2026-11-16",
      "name": "BaumstaenderTTV"
    }
  ],
  "page_schema": "forts-player-page/1",
  "rank": 1,
  "reason": null,
  "schema": "forts-player/1",
  "score": 4714,
  "season": null,
  "season_results": [
    {
      "builds": [
        "1.38.2-r22447",
        "1.39.0-r22745",
        "1.39.0-r22875"
      ],
      "games": 102,
      "losses": 14,
      "mode": "1v1",
      "peak": 4714,
      "provisional": false,
      "rank": 1,
      "score": 4714,
      "season": 44,
      "standing_basis": "games10",
      "top_pct": 0.1,
      "wins": 88,
      "wl_basis": "record"
    }
  ],
  "seasons": [
    44,
    43,
    42
  ],
  "source": "https://forts-tools.com/player/76561198974455664",
  "standing": {
    "basis": "games10",
    "builds": [
      "1.38.2-r22447",
      "1.39.0-r22745",
      "1.39.0-r22875"
    ],
    "field": 953,
    "games": 102,
    "mode": "1v1",
    "provisional": false,
    "rank": 1,
    "score": 4714,
    "season": 44,
    "top_pct": 0.1,
    "total": 3490
  },
  "steam_id": "76561198974455664",
  "streak": {
    "current": {
      "n": 18,
      "won": true
    },
    "longest_lost": 6,
    "longest_won": 20
  },
  "wins": 88
}

/api/player-names

Every account a season's ranked ladder listed, with the names it is known by.

RequestGET https://forts-tools.com/api/player-names
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-ranked-names/1
Same data as/leaderboard
AuthenticationNone. No key, no origin allow-list.

Parameters

NameInTypeRequiredNotes
seasonqueryintegeroptionalSeason number. Absent: the current season. A season the site holds no data for, or anything but 1 to 3 digits: 404.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
sourcestringfalseThe page that shows the same data.
definitionstringfalseWhat the figures mean, in English.
seasonintegertrueSeason number.
current_seasonintegertrueThe season the live board is in.
seasonsarray<integer>falseEvery season the site holds, newest first.
archivedbooleanfalseTrue when the answer is a closed season.
captured_utcstringtrueWhen the standings were read from the game.
generated_utcstringtrueWhen this answer was computed.
totalintegerfalseAccounts found for the season.
on_boardintegerfalseAccounts on the season's standings.
unresolvedintegerfalseStandings rows whose account could not be resolved, left out.
truncatedbooleanfalseTrue when more than 25000 accounts were found and the list is cut.
playersarray<object>falseOne entry per account: standings rows first, then every other account the season's sweeps listed.
players[].steam_idstringfalseSteamID64 of the account.
players[].namestringtrueThe name the standings or newest sweep carried; null for a placeholder.
players[].rankintegertrueRank on the season's standings; null when not on them.
players[].boardstringtrueBoard key the account was listed on.
players[].other_namesarray<string>falseOther names the account used, newest first, at most 20.
players[].winsintegertrueThe game's season-to-date win counter at the newest match record.
players[].lossesintegertrueThe game's season-to-date loss counter at the newest match record.
reasonstringtrueWhy the answer is empty or partial, in English; null when it is complete.

Statuses

StatusMeaning
200The answer. An empty or partial answer is still 200 and says why in reason.
304Not modified: If-None-Match matched the current ETag.
404season names a season the site holds no data for.
405A method other than GET or HEAD.
429A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers.
500An unexpected server fault.
503The store cannot be read (same JSON shape, reason set), or the endpoint is switched off.

Caching and freshness

Cache-Controlpublic, max-age=300
ValidatorsWeak ETag; a matching If-None-Match is answered 304 with no body. Content-Encoding: gzip when the request sends Accept-Encoding: gzip.
Server-side reuseA computed answer is reused for up to 300 s; new data from the stores replaces it at once.
FreshnessFollows the ranked ladder sweep; captured_utc says when the standings were read from the game.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/player-names

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "archived": false,
  "captured_utc": "2026-11-16T23:35:11Z",
  "current_season": 44,
  "definition": "Every account the season's ranked sweeps listed. rank is the /leaderboard rank, null when the account is not on the season's standings (current, or a closed se…",
  "generated_utc": "2026-11-16T23:35:42Z",
  "on_board": 3490,
  "players": [
    {
      "board": "1v1",
      "losses": 14,
      "name": "BaumstaenderTTV",
      "other_names": [],
      "rank": 1,
      "steam_id": "76561198974455664",
      "wins": 88
    }
  ],
  "reason": null,
  "schema": "forts-ranked-names/1",
  "season": 44,
  "seasons": [
    44,
    43,
    42
  ],
  "source": "https://forts-tools.com/leaderboard",
  "total": 3495,
  "truncated": false,
  "unresolved": 0
}

/api/players

The player and lobby counts the lobbies page shows for the live game build.

RequestGET https://forts-tools.com/api/players
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-players/1
Same data as/lobbies
AuthenticationNone. No key, no origin allow-list.

Parameters

No parameters.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
sourcestringfalseThe page that shows the same data.
definitionstringfalseWhat the figures mean, in English.
lobbies_definitionstringfalseWhat the lobby counts mean, in English.
captured_utcstringtrueWhen the newest player count was taken.
age_sintegertrueSeconds since that count.
playersintegertruePlayers in game, Valve's own current-player count.
players_peakintegertrueHighest players figure since peak_since_utc.
peak_since_utcstringtrueStart of the window players_peak covers.
samplesintegerfalseCounts held in the window.
buildstringtrueThe live game build the lobby counts are for.
lobbiesobjecttrueLobbies for the live build, per state.
lobbies.{bucket}integerfalseLobbies in this state. Keys: open, locked, forming, not_started, in_progress, total
by_modeobjecttrueThe same counts split into ranked and casual.
by_mode.{mode}objectfalseCounts per state for one mode. Keys: ranked, casual
by_mode.{mode}.{bucket}integerfalseLobbies in this state. Keys: open, locked, forming, not_started, in_progress, total
coverage_completebooleantrueTrue when the lobby list was read in full.
result_capintegertrueMost lobbies one list request returns.
reasonstringtrueWhy the answer is empty or partial, in English; null when it is complete.

Statuses

StatusMeaning
200The answer. An empty or partial answer is still 200 and says why in reason.
405A method other than GET or HEAD.
429A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers.
500An unexpected server fault.
503The store cannot be read (same JSON shape, reason set), or the endpoint is switched off.

Caching and freshness

Cache-Controlno-store, max-age=0
FreshnessRead on every request; captured_utc and age_s say when the newest count was taken.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/players

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "age_s": 6,
  "build": "1.39.0",
  "by_mode": {
    "casual": {
      "forming": 0,
      "in_progress": 12,
      "locked": 2,
      "not_started": 3,
      "open": 1,
      "total": 15
    },
    "ranked": {
      "forming": 0,
      "in_progress": 1,
      "locked": 0,
      "not_started": 0,
      "open": 0,
      "total": 1
    }
  },
  "captured_utc": "2026-11-16T23:35:37Z",
  "coverage_complete": true,
  "definition": "Players in game: Valve's own current-player count for Forts (ISteamUserStats/GetNumberOfCurrentPlayers) at the newest count, drawn on /lobbies as the 'Players …",
  "lobbies": {
    "forming": 0,
    "in_progress": 13,
    "locked": 2,
    "not_started": 3,
    "open": 1,
    "total": 16
  },
  "lobbies_definition": "Lobbies on the public Steam lobby list for the live build at the newest count, as the /lobbies headline table shows them; not_started = open + password + filli…",
  "peak_since_utc": "2026-11-02T23:35:39Z",
  "players": 181,
  "players_peak": 673,
  "reason": null,
  "result_cap": 50,
  "samples": 214478,
  "schema": "forts-players/1",
  "source": "https://forts-tools.com/lobbies"
}

/api/live

Ranked matches in progress and ranked lobbies waiting for an opponent, as the live page shows them.

RequestGET https://forts-tools.com/api/live
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-live/1
Same data as/live
AuthenticationNone. No key, no origin allow-list.

Parameters

No parameters.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
generated_utcstringfalseWhen this answer was built.
win_chance_methodstringfalseHow win_chance is computed, in English.
matchesarray<object>falseRanked matches running now, newest start first.
matches[].started_utcstringtrueWhen the match started.
matches[].mapstringtrueMap name; null when not known.
matches[].seasonstringtrueSeason the lobby named.
matches[].buildstringtrueGame build at the match's start.
matches[].basisstringfalseWhich feeds show the match: lobby, record or both.
matches[].methodstringtrueHow win_chance was computed for this match: elo or stake; null when neither applies.
matches[].playersarray<object>falseThe two players.
matches[].players[].steam_idstringfalseSteamID64 of the account.
matches[].players[].namestringtrueName of the account as Steam shows it.
matches[].players[].rankintegertruePosition on the board, 1 is the top.
matches[].players[].scoreintegertrueBoard score, the Rating column of the leaderboard page.
matches[].players[].ratingintegertrueInternal rating before the match.
matches[].players[].stakeintegertruePoints at stake for this player.
matches[].players[].win_chancenumbertrueExpected chance of winning, 0 to 1.
lobby_list_captured_utcstringtrueWhen the lobby list was captured.
queue_captured_utcstringtrueSame as lobby_list_captured_utc; kept for clients that read it.
open_rankedarray<object>falseRanked lobbies waiting for an opponent: not started, no password, and players below max_players. A lobby leaves this list as soon as the opponent joins.
open_ranked[].host_steam_idstringtrueSteamID64 of the host.
open_ranked[].host_namestringtrueName of the host.
open_ranked[].host_rankintegertrueThe host's board position.
open_ranked[].host_scoreintegertrueThe host's board score.
open_ranked[].host_ratingintegertrueThe host's internal rating.
open_ranked[].rankscoreintegertrueScore the lobby advertises.
open_ranked[].max_playersintegertrueSeats in the lobby.
open_ranked[].mapstringtrueMap name; null when not known.
open_ranked[].versionstringtrueGame version.
open_ranked[].regionstringtrueRegion the lobby is hosted in.
open_ranked[].first_seen_utcstringtrueWhen the lobby was first listed.
open_ranked[].queue_statestringtrueThe lobby's queue state token.
open_ranked[].tick_age_sintegertrueSeconds since the lobby last updated.
errorstringfalseWhy the answer holds nothing, in English. Present only when the store cannot be read; the answer then holds schema and this field only.

Statuses

StatusMeaning
200The answer, also when the store cannot be read: the body then holds schema and error only.
405A method other than GET or HEAD.
429A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers.
500An unexpected server fault.
503The endpoint is switched off.

Caching and freshness

Cache-Controlno-store, max-age=0
FreshnessRead on every request; lobby_list_captured_utc is the time of the lobby list the answer was built from.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/live

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "generated_utc": "2026-11-16T23:35:43Z",
  "lobby_list_captured_utc": "2026-11-16T23:35:37Z",
  "matches": [
    {
      "basis": "both",
      "build": "1.39.0-r22875",
      "map": "Pillars",
      "method": "elo",
      "players": [
        {
          "name": "枯木龙吟干死阅览",
          "rank": 1983,
          "rating": 973,
          "score": 4049,
          "stake": 15,
          "steam_id": "76561198733505730",
          "win_chance": 0.4741190691088309
        }
      ],
      "season": "44",
      "started_utc": "2026-11-16T23:35:02Z"
    }
  ],
  "open_ranked": [],
  "queue_captured_utc": "2026-11-16T23:35:37Z",
  "schema": "forts-live/1",
  "win_chance_method": "elo: 1/(1+10^((Rb-Ra)/400)) on internal ratings before the match, K=32; stake: E = stake/32"
}

/api/builds

The game builds the old-build page offers, newest first.

RequestGET https://forts-tools.com/api/builds
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-builds/1
Same data as/steamcmd
AuthenticationNone. No key, no origin allow-list.

Parameters

No parameters.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
sourcestringfalseThe page that shows the same data.
buildsarray<object>falseGame builds, newest first.
builds[].idstringfalseThe site's id for the build: version and revision.
builds[].versionstringfalseGame version.
builds[].revisionstringtrueThe game's revision.
builds[].labelstringfalseDisplay name of the build.
builds[].build_idstringtrueSteam's build id.
builds[].releasedstringtrueRelease day.
builds[].currentbooleanfalseTrue for the live build.
builds[].steamcmdbooleanfalseTrue when the old-build page can write a SteamCMD command for it.

Statuses

StatusMeaning
200The answer. An empty or partial answer is still 200 and says why in reason.
405A method other than GET or HEAD.
429A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers.
500An unexpected server fault.
503The endpoint is switched off.

Caching and freshness

Cache-Controlno-store, max-age=0
FreshnessChanges when a game build is added to the site.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/builds

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "builds": [
    {
      "build_id": "26581374",
      "current": true,
      "id": "1.39.0-r22875",
      "label": "Forts 1.39.0 (r22875)",
      "released": "2026-11-11",
      "revision": "r22875",
      "steamcmd": true,
      "version": "1.39.0"
    }
  ],
  "schema": "forts-builds/1",
  "source": "https://forts-tools.com/steamcmd"
}

/api/data

The data files the data page offers, in its order, with their checksums.

RequestGET https://forts-tools.com/api/data
MethodsGET, HEAD
Response bodyapplication/json; charset=utf-8
Schema markerforts-data/1
Same data as/data
AuthenticationNone. No key, no origin allow-list.

Parameters

No parameters.

Response

FieldTypeNullableDescription
schemastringfalseSchema marker of this answer.
sourcestringfalseThe page that shows the same data.
generatedstringtrueDay the files were published.
provenancestringtrueWhere the data comes from, in English.
filesarray<object>falseThe files, in the data page's order.
files[].filestringfalseFile name.
files[].urlstringfalseDownload path on this site.
files[].kindstringfalseKind of file.
files[].patchstringfalseGame version and revision the file covers.
files[].buildstringfalseSteam build id; empty for a file spanning several builds.
files[].sizestringfalseSize, written for people.
files[].sha256stringfalseSHA-256 of the file.
files[].descriptionstringfalseWhat the file holds, in English.

Statuses

StatusMeaning
200The answer. An empty or partial answer is still 200 and says why in reason.
405A method other than GET or HEAD.
429A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers.
500An unexpected server fault.
503The endpoint is switched off.

Caching and freshness

Cache-Controlno-store, max-age=0
FreshnessChanges when the data files are published again; generated is their date.

Limits

LimitValueNotes
Requests per address (proxy)300r/m burst=100Over the burst: 429 with Retry-After 1.
Open connections per address (proxy)8One more: 429. Over HTTP/2 each request in flight counts.
Request budget per address (application)120/60sOne bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers.

Example request

curl -s https://forts-tools.com/api/data

Example response

A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.

{
  "files": [
    {
      "build": "26581374",
      "description": "Every buildable item's numbers for the current game build — weapons, devices, materials, projectiles, commanders and what each commander changes.",
      "file": "Forts_SourceOfTruth_1-39-0_r22875_build26581374.xlsx",
      "kind": "workbook",
      "patch": "1.39.0 r22875",
      "sha256": "cf94f545e5ea682792f32b2717874f7768be644b62c57da8bc1ad8117f55f091",
      "size": "199 KB",
      "url": "/data/Forts_SourceOfTruth_1-39-0_r22875_build26581374.xlsx"
    }
  ],
  "generated": "2026-11-11",
  "provenance": "This automates a pipeline these people built by hand; it does not replace their work. It was built against Endo's dump mod, which is where these numbers first …",
  "schema": "forts-data/1",
  "source": "https://forts-tools.com/data"
}

Uploads

The upload endpoints take a file by POST; a long answer comes in pages, the further pages by GET. Each is documented on its own tool's page.

EndpointReferenceSchema marker
POST /api/replayWorkbenchforts-replay/1
POST /api/versionReplay versionforts-version/2
POST /api/telemetryYour ranked historyforts-telemetry/2
GET /api/telemetry/<job>/<page>Your ranked historyforts-telemetry/2