API reference

Every example answer below is what a test key gets from the sandbox, through the same schema the API uses, so it is exactly what you will see. Snippets read the key from GWL_API_KEY. Keys, limits and errors are in The API.

Team routes

A team key, live or test. Each answers with the key’s own team only.

GET /api/v1/team

The team this key belongs to. Scope: team.read (Team record).

Request, curl
curl "https://gwl.gg/api/v1/team" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "slug": "test-team",
  "name": "Test Team",
  "tag": "TEST",
  "region": "EU",
  "description": "An invented team for building against the API. Nothing here is real.",
  "flag": "GB",
  "flags": [
    "GB"
  ],
  "eloRating": 1482,
  "ratedMatches": 12,
  "seasonMatches": 6,
  "placements": {
    "first": 2,
    "second": 7,
    "third": 3
  },
  "seasonPlacements": {
    "first": 1,
    "second": 4,
    "third": 1
  },
  "score": 781,
  "seasonScore": 406,
  "form": [
    2,
    2,
    1,
    2,
    2
  ],
  "reputationScore": 79,
  "safetyBand": "Excellent",
  "rosterCount": 8,
  "leagueRank": 6
}
Fields of the answer (25)
slug
string The team’s address on the site (/teams/<slug>): its id here
name
string Team name
tag
string Team tag
region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
description
string What the team wrote about itself; may be empty
flag
string, may be null The team’s primary flag, the one lists show: an ISO country code (GB, DE) or region:<code> for a region flag; null when none is chosen
flags
array of string The team’s profile flags in order, primary first, up to three: each an ISO country code (GB, DE) or region:<code> for a region flag; empty when none is chosen
eloRating
integer The Elo Rating: one ongoing all-time number, as on every page
ratedMatches
integer Rated matches, all time
seasonMatches
integer Matches this season
placements
object How often the team finished 1st, 2nd and 3rd
placements.first
integer Times finished 1st
placements.second
integer Times finished 2nd
placements.third
integer Times finished 3rd
seasonPlacements
object How often the team finished 1st, 2nd and 3rd this season
seasonPlacements.first
integer Times finished 1st
seasonPlacements.second
integer Times finished 2nd
seasonPlacements.third
integer Times finished 3rd
score
number In-game score summed over counted matches, all time
seasonScore
number In-game score summed over counted matches, this season
form
array of integer Last five finishes (1, 2 or 3), oldest first
reputationScore
number Reputation, 0 to 100
safetyBand
string Excellent, Good, Fair or Poor: the band of the Safety part of the reputation score
rosterCount
integer People on the active roster
leagueRank
integer, may be null Place in the league table; null before a counted match

GET /api/v1/team/members

The team’s members. Scope: members.read (Members).

Adds discordName with members.discord, discordId with members.discord_id and steamId with members.steam_id (Team Leader only). Each field is absent without its scope. Only the team’s own members are listed.

Request, curl
curl "https://gwl.gg/api/v1/team/members" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "members": [
    {
      "name": "Ada Example",
      "role": "owner",
      "joinedAt": "2026-07-19T12:00:00.000Z",
      "linked": true,
      "playerId": "test-player-01",
      "country": "GB",
      "roleLabels": [
        "Commander"
      ],
      "discordName": "ada.example",
      "discordId": "10000000000000001",
      "steamId": "76561190000000001"
    },
    {
      "name": "Bram Sample",
      "role": "manager",
      "joinedAt": "2026-07-23T12:00:00.000Z",
      "linked": true,
      "playerId": "test-player-02",
      "country": "NL",
      "roleLabels": [
        "Pilot"
      ],
      "discordName": "bram.sample",
      "discordId": "10000000000000002",
      "steamId": "76561190000000002"
    },
    {
      "name": "Cleo Placeholder",
      "role": "manager",
      "joinedAt": "2026-08-18T12:00:00.000Z",
      "linked": true,
      "playerId": "test-player-03",
      "country": "FR",
      "discordName": "cleo.placeholder",
      "discordId": "10000000000000003",
      "steamId": "76561190000000003"
    },
    {
      "name": "Dmitri Mock",
      "role": "player",
      "joinedAt": "2026-09-17T12:00:00.000Z",
      "linked": true,
      "playerId": "test-player-04",
      "country": "PL",
      "roleLabels": [
        "Medic"
      ],
      "discordName": "dmitri.mock",
      "discordId": "10000000000000004",
      "steamId": "76561190000000004"
    },
    {
      "name": "Eun-ji Testcase",
      "role": "player",
      "joinedAt": "2026-10-12T12:00:00.000Z",
      "linked": true,
      "playerId": "test-player-05",
      "country": "KR",
      "discordName": "eunji.testcase",
      "discordId": "10000000000000005",
      "steamId": "76561190000000005"
    },
    {
      "name": "Femi Dummy",
      "role": "player",
      "joinedAt": "2026-11-16T12:00:00.000Z",
      "linked": true,
      "playerId": "test-player-06",
      "country": "NG",
      "roleLabels": [
        "Merc"
      ],
      "discordName": "femi.dummy",
      "discordId": "10000000000000006",
      "steamId": "76561190000000006"
    },
    {
      "name": "Gustav Stub",
      "role": "player",
      "joinedAt": "2026-12-16T12:00:00.000Z",
      "linked": true,
      "playerId": "test-player-07",
      "discordName": "gustav.stub",
      "discordId": "10000000000000007",
      "steamId": "76561190000000007"
    },
    {
      "name": "Hana Fixture",
      "role": "player",
      "joinedAt": "2027-01-03T12:00:00.000Z",
      "linked": false,
      "playerId": "test-player-08",
      "country": "JP",
      "discordId": null,
      "steamId": "76561190000000008"
    }
  ]
}
Fields of the answer (11)
members
array of object Everyone on the team, Leader first
members[].name
string Display name
members[].role
string owner (Team Leader), manager (Team Rep) or player
members[].joinedAt
string (date-time) When they joined the team. UTC, ISO 8601
members[].linked
boolean Has a site account (false: a roster row only)
members[].playerId
string, may be absent Their player page id (/players/<id>), when they have one
members[].country
string, may be absent ISO 3166-1 alpha-2 country the person chose to show
members[].roleLabels
array of string, may be absent Team roles the team gave them (Pilot, Medic): labels only
members[].discordName
string, may be absent Discord username. Only with the members.discord scope
members[].discordId
string, may be null, may be absent Discord account ID. Only with the members.discord_id scope (absent without it); null when the member has not linked Discord
members[].steamId
string, may be null, may be absent SteamID64. Only with the members.steam_id scope, which only the Team Leader can tick (absent without it); null when none is known

GET /api/v1/team/applications

People waiting to join. Scope: applications.read (Read applications).

Adds each applicant’s discordId with members.discord_id (absent without it). An applicant’s Steam ID is never returned.

Request, curl
curl "https://gwl.gg/api/v1/team/applications" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "applications": [
    {
      "id": "test-app-01",
      "name": "Ines Sample",
      "country": "PT",
      "regions": [
        "EU"
      ],
      "note": "Medic main, free most evenings UTC.",
      "appliedAt": "2027-01-13T12:00:00.000Z",
      "deadline": "2027-01-20T12:00:00.000Z",
      "playerId": "test-player-41",
      "elo": 1512,
      "ratedMatches": 9,
      "discordId": "10000000000000041"
    },
    {
      "id": "test-app-02",
      "name": "Kai Placeholder",
      "country": null,
      "regions": [
        "NA",
        "OCE"
      ],
      "note": null,
      "appliedAt": "2027-01-14T12:00:00.000Z",
      "deadline": "2027-01-21T12:00:00.000Z",
      "playerId": null,
      "elo": null,
      "ratedMatches": 0,
      "discordId": "10000000000000042"
    }
  ]
}
Fields of the answer (12)
applications
array of object Open applications, oldest first
applications[].id
string Application id, for the respond route
applications[].name
string Display name of the person applying
applications[].country
string, may be null ISO 3166-1 alpha-2 country the person chose to show; null when none
applications[].regions
array of string Regions they play in, as codes
applications[].note
string, may be null What they wrote, up to 280 characters; null when nothing
applications[].appliedAt
string (date-time) When they applied. UTC, ISO 8601
applications[].deadline
string (date-time) When it expires unanswered. UTC, ISO 8601
applications[].playerId
string, may be null Their player page id (/players/<id>), when they have one; null when none
applications[].elo
integer, may be null Their player Elo Rating; null before a rated match
applications[].ratedMatches
integer Rated matches they have played
applications[].discordId
string, may be null, may be absent Discord account ID. Only with the members.discord_id scope (absent without it). An applicant’s Steam ID is never returned

POST /api/v1/team/applications/{id}/respond

Accept or decline an application. Scope: applications.write (Answer applications).

Body, as JSON

accept
boolean true to take them on, false to decline
reason
string, may be absent Optional words for them, up to 280 characters
Request, curl
curl -X POST "https://gwl.gg/api/v1/team/applications/test-app-01/respond" \
  -H "Authorization: Bearer $GWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accept":true}'
Example answer, 200
{
  "id": "test-app-01",
  "accepted": true,
  "name": "Ines Sample"
}
Fields of the answer (3)
id
string The application id
accepted
boolean Whether they joined
name
string Display name of the person

GET /api/v1/team/fixtures

Upcoming and recent matches. Scope: matches.read (Matches).

Query parameters, all optional

limit
integer How many, up to 100
Request, curl
curl "https://gwl.gg/api/v1/team/fixtures?limit=2" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "upcoming": [
    {
      "number": "9105",
      "status": "scheduled",
      "rated": false,
      "region": "EU",
      "map": "sabatulo",
      "layer": "Default",
      "weather": "clear",
      "season": "Sandbox Season",
      "startsAt": "2027-01-17T19:00:00.000Z",
      "concludedAt": null,
      "durationSeconds": null,
      "host": "test-team",
      "sides": [
        {
          "team": {
            "slug": "test-team",
            "name": "Test Team",
            "tag": "TEST"
          },
          "faction": "lonestar",
          "score": null,
          "placement": null,
          "points": null,
          "eloDelta": null
        },
        {
          "team": {
            "slug": "example-eagles",
            "name": "Example Eagles",
            "tag": "EXEG"
          },
          "faction": null,
          "score": null,
          "placement": null,
          "points": null,
          "eloDelta": null
        },
        {
          "team": {
            "slug": "sample-sappers",
            "name": "Sample Sappers",
            "tag": "SMPL"
          },
          "faction": null,
          "score": null,
          "placement": null,
          "points": null,
          "eloDelta": null
        }
      ],
      "lockedAt": "2027-01-14T19:00:00.000Z",
      "serverPosted": false,
      "readyTeams": [
        "test-team"
      ]
    },
    {
      "number": "9106",
      "status": "scheduled",
      "rated": false,
      "region": "EU",
      "map": "kavkazi",
      "layer": "Farmland",
      "weather": null,
      "season": "Sandbox Season",
      "startsAt": "2027-01-20T19:00:00.000Z",
      "concludedAt": null,
      "durationSeconds": null,
      "host": "stub-strikers",
      "sides": [
        {
          "team": {
            "slug": "stub-strikers",
            "name": "Stub Strikers",
            "tag": "STUB"
          },
          "faction": "lonestar",
          "score": null,
          "placement": null,
          "points": null,
          "eloDelta": null
        },
        {
          "team": {
            "slug": "test-team",
            "name": "Test Team",
            "tag": "TEST"
          },
          "faction": null,
          "score": null,
          "placement": null,
          "points": null,
          "eloDelta": null
        },
        {
          "team": {
            "slug": "mock-mortars",
            "name": "Mock Mortars",
            "tag": "MOCK"
          },
          "faction": null,
          "score": null,
          "placement": null,
          "points": null,
          "eloDelta": null
        }
      ],
      "lockedAt": "2027-01-17T19:00:00.000Z",
      "serverPosted": true,
      "readyTeams": []
    }
  ],
  "recent": [
    {
      "number": "9104",
      "status": "reported",
      "rated": false,
      "region": "EU",
      "map": "europe",
      "layer": "River",
      "weather": null,
      "season": "Sandbox Season",
      "startsAt": "2027-01-14T19:00:00.000Z",
      "concludedAt": null,
      "durationSeconds": 3360,
      "host": "lorem-lancers",
      "sides": [
        {
          "team": {
            "slug": "lorem-lancers",
            "name": "Lorem Lancers",
            "tag": "LORM"
          },
          "faction": "lonestar",
          "score": 74,
          "placement": 2,
          "points": 2,
          "eloDelta": null
        },
        {
          "team": {
            "slug": "test-team",
            "name": "Test Team",
            "tag": "TEST"
          },
          "faction": "valkyra",
          "score": 100,
          "placement": 1,
          "points": 3,
          "eloDelta": null
        },
        {
          "team": {
            "slug": "ipsum-infantry",
            "name": "Ipsum Infantry",
            "tag": "IPSM"
          },
          "faction": "manticore",
          "score": 38,
          "placement": 3,
          "points": 1,
          "eloDelta": null
        }
      ],
      "lockedAt": "2027-01-11T19:00:00.000Z",
      "serverPosted": true,
      "readyTeams": [
        "lorem-lancers",
        "test-team",
        "ipsum-infantry"
      ]
    },
    {
      "number": "9103",
      "status": "confirmed",
      "rated": true,
      "region": "EU",
      "map": "north-america",
      "layer": "Houses",
      "weather": "rain",
      "season": "Sandbox Season",
      "startsAt": "2027-01-11T19:00:00.000Z",
      "concludedAt": "2027-01-11T21:59:00.000Z",
      "durationSeconds": 3540,
      "host": "test-team",
      "sides": [
        {
          "team": {
            "slug": "test-team",
            "name": "Test Team",
            "tag": "TEST"
          },
          "faction": "lonestar",
          "score": 65,
          "placement": 2,
          "points": 2,
          "eloDelta": 0
        },
        {
          "team": {
            "slug": "dummy-dragoons",
            "name": "Dummy Dragoons",
            "tag": "DUMY"
          },
          "faction": "valkyra",
          "score": 100,
          "placement": 1,
          "points": 3,
          "eloDelta": 18
        },
        {
          "team": {
            "slug": "fixture-falcons",
            "name": "Fixture Falcons",
            "tag": "FIXT"
          },
          "faction": "manticore",
          "score": 34,
          "placement": 3,
          "points": 1,
          "eloDelta": -16
        }
      ],
      "lockedAt": "2027-01-08T19:00:00.000Z",
      "serverPosted": true,
      "readyTeams": [
        "test-team",
        "dummy-dragoons",
        "fixture-falcons"
      ]
    }
  ]
}
Fields of the answer (52)
upcoming
array of object Matches not played yet, soonest first
upcoming[].number
string The match number, as on the website
upcoming[].status
string scheduled (locked, not played), reported (result in, waiting), confirmed or disputed
upcoming[].rated
boolean Whether the result has moved Elo
upcoming[].region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
upcoming[].map
string Map id: kavkazi, europe, north-america or sabatulo
upcoming[].layer
string, may be null Zone name on that map; null for Random or none
upcoming[].weather
string, may be null Weather key (clear, overcast, rain, fog, storm), or null for any
upcoming[].season
string Name of the season the match belongs to
upcoming[].startsAt
string (date-time) When it starts. UTC, ISO 8601
upcoming[].concludedAt
string (date-time), may be null When the result was confirmed; null before. UTC, ISO 8601
upcoming[].durationSeconds
integer, may be null How long it was played, in seconds; null when unknown
upcoming[].host
string Team slug of the host
upcoming[].sides
array of object The three teams, host first
upcoming[].sides[].team
object A team, by slug, name and tag
upcoming[].sides[].team.slug
string The team’s address on the site (/teams/<slug>): its id here
upcoming[].sides[].team.name
string, may be null Team name; null if it is gone
upcoming[].sides[].team.tag
string, may be null Team tag; null if it is gone
upcoming[].sides[].faction
string, may be null Faction code once a moderator assigns one, else null
upcoming[].sides[].score
number, may be null The side’s in-game score, 0 to 100; null before a result
upcoming[].sides[].placement
integer, may be null 1, 2 or 3; null before a result
upcoming[].sides[].points
number, may be null Placement points for the match: 3 for 1st, 2 for 2nd, 1 for 3rd
upcoming[].sides[].eloDelta
number, may be null Elo change from this match; null until it is rated
upcoming[].lockedAt
string (date-time), may be null When the third team joined and it became a match. UTC, ISO 8601
upcoming[].serverPosted
boolean Whether the host has posted server details. The address itself is never returned
upcoming[].readyTeams
array of string Slugs of the teams that pressed Ready
recent
array of object Played matches, newest first
recent[].number
string The match number, as on the website
recent[].status
string scheduled (locked, not played), reported (result in, waiting), confirmed or disputed
recent[].rated
boolean Whether the result has moved Elo
recent[].region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
recent[].map
string Map id: kavkazi, europe, north-america or sabatulo
recent[].layer
string, may be null Zone name on that map; null for Random or none
recent[].weather
string, may be null Weather key (clear, overcast, rain, fog, storm), or null for any
recent[].season
string Name of the season the match belongs to
recent[].startsAt
string (date-time) When it starts. UTC, ISO 8601
recent[].concludedAt
string (date-time), may be null When the result was confirmed; null before. UTC, ISO 8601
recent[].durationSeconds
integer, may be null How long it was played, in seconds; null when unknown
recent[].host
string Team slug of the host
recent[].sides
array of object The three teams, host first
recent[].sides[].team
object A team, by slug, name and tag
recent[].sides[].team.slug
string The team’s address on the site (/teams/<slug>): its id here
recent[].sides[].team.name
string, may be null Team name; null if it is gone
recent[].sides[].team.tag
string, may be null Team tag; null if it is gone
recent[].sides[].faction
string, may be null Faction code once a moderator assigns one, else null
recent[].sides[].score
number, may be null The side’s in-game score, 0 to 100; null before a result
recent[].sides[].placement
integer, may be null 1, 2 or 3; null before a result
recent[].sides[].points
number, may be null Placement points for the match: 3 for 1st, 2 for 2nd, 1 for 3rd
recent[].sides[].eloDelta
number, may be null Elo change from this match; null until it is rated
recent[].lockedAt
string (date-time), may be null When the third team joined and it became a match. UTC, ISO 8601
recent[].serverPosted
boolean Whether the host has posted server details. The address itself is never returned
recent[].readyTeams
array of string Slugs of the teams that pressed Ready

GET /api/v1/team/matches/{number}

One of the team’s matches. Scope: matches.read (Matches).

Request, curl
curl "https://gwl.gg/api/v1/team/matches/9103" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "number": "9103",
  "status": "confirmed",
  "rated": true,
  "region": "EU",
  "map": "north-america",
  "layer": "Houses",
  "weather": "rain",
  "season": "Sandbox Season",
  "startsAt": "2027-01-11T19:00:00.000Z",
  "concludedAt": "2027-01-11T21:59:00.000Z",
  "durationSeconds": 3540,
  "host": "test-team",
  "sides": [
    {
      "team": {
        "slug": "test-team",
        "name": "Test Team",
        "tag": "TEST"
      },
      "faction": "lonestar",
      "score": 65,
      "placement": 2,
      "points": 2,
      "eloDelta": 0
    },
    {
      "team": {
        "slug": "dummy-dragoons",
        "name": "Dummy Dragoons",
        "tag": "DUMY"
      },
      "faction": "valkyra",
      "score": 100,
      "placement": 1,
      "points": 3,
      "eloDelta": 18
    },
    {
      "team": {
        "slug": "fixture-falcons",
        "name": "Fixture Falcons",
        "tag": "FIXT"
      },
      "faction": "manticore",
      "score": 34,
      "placement": 3,
      "points": 1,
      "eloDelta": -16
    }
  ],
  "lockedAt": "2027-01-08T19:00:00.000Z",
  "serverPosted": true,
  "readyTeams": [
    "test-team",
    "dummy-dragoons",
    "fixture-falcons"
  ]
}
Fields of the answer (25)
number
string The match number, as on the website
status
string scheduled (locked, not played), reported (result in, waiting), confirmed or disputed
rated
boolean Whether the result has moved Elo
region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
map
string Map id: kavkazi, europe, north-america or sabatulo
layer
string, may be null Zone name on that map; null for Random or none
weather
string, may be null Weather key (clear, overcast, rain, fog, storm), or null for any
season
string Name of the season the match belongs to
startsAt
string (date-time) When it starts. UTC, ISO 8601
concludedAt
string (date-time), may be null When the result was confirmed; null before. UTC, ISO 8601
durationSeconds
integer, may be null How long it was played, in seconds; null when unknown
host
string Team slug of the host
sides
array of object The three teams, host first
sides[].team
object A team, by slug, name and tag
sides[].team.slug
string The team’s address on the site (/teams/<slug>): its id here
sides[].team.name
string, may be null Team name; null if it is gone
sides[].team.tag
string, may be null Team tag; null if it is gone
sides[].faction
string, may be null Faction code once a moderator assigns one, else null
sides[].score
number, may be null The side’s in-game score, 0 to 100; null before a result
sides[].placement
integer, may be null 1, 2 or 3; null before a result
sides[].points
number, may be null Placement points for the match: 3 for 1st, 2 for 2nd, 1 for 3rd
sides[].eloDelta
number, may be null Elo change from this match; null until it is rated
lockedAt
string (date-time), may be null When the third team joined and it became a match. UTC, ISO 8601
serverPosted
boolean Whether the host has posted server details. The address itself is never returned
readyTeams
array of string Slugs of the teams that pressed Ready

GET /api/v1/team/matches/{number}/file

The raw match file of one of the team’s matches. Scope: matches.file (Match files).

Built from the league server’s live feed after the match, in the format the league reads. Includes Steam IDs. 404 until the file exists, and for a match the team was not in.

Request, curl
curl "https://gwl.gg/api/v1/team/matches/9103/file" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "id": "gwl-9103",
  "map": "north-america",
  "startedAt": "2027-01-11T19:10:00.000Z",
  "endedAt": null,
  "reason": null,
  "endReason": null,
  "coverage": "observed",
  "eventCount": 5,
  "events": [
    {
      "id": "sandbox-9103-0",
      "type": "player_killed",
      "sequence": 0,
      "at": "2027-01-11T19:10:00.000Z",
      "victimSteamId": "76561190000000002",
      "victimName": "Sandbox Two",
      "killerSteamId": "76561190000000001",
      "killerName": "Sandbox One",
      "cause": "AK74",
      "weaponId": "AK74",
      "mapName": "north-america",
      "matchId": "9103",
      "distance": 14200,
      "eventTime": 1799694600,
      "contextTags": []
    },
    {
      "id": "sandbox-9103-1",
      "type": "player_killed",
      "sequence": 1,
      "at": "2027-01-11T19:17:00.000Z",
      "victimSteamId": "76561190000000004",
      "victimName": "Sandbox Four",
      "killerSteamId": "76561190000000003",
      "killerName": "Sandbox Three",
      "cause": "M4A1",
      "weaponId": "M4A1",
      "mapName": "north-america",
      "matchId": "9103",
      "distance": 3100,
      "eventTime": 1799695020,
      "contextTags": []
    },
    {
      "id": "sandbox-9103-2",
      "type": "player_killed",
      "sequence": 2,
      "at": "2027-01-11T19:24:00.000Z",
      "victimSteamId": "76561190000000003",
      "victimName": "Sandbox Three",
      "killerSteamId": "76561190000000001",
      "killerName": "Sandbox One",
      "cause": "SVD",
      "weaponId": "SVD",
      "mapName": "north-america",
      "matchId": "9103",
      "distance": 30500,
      "eventTime": 1799695440,
      "contextTags": [
        "Meta.Progression.Context.Player.KillContext.Headshot"
      ]
    },
    {
      "id": "sandbox-9103-3",
      "type": "player_killed",
      "sequence": 3,
      "at": "2027-01-11T19:31:00.000Z",
      "victimSteamId": "76561190000000001",
      "victimName": "Sandbox One",
      "killerSteamId": "76561190000000002",
      "killerName": "Sandbox Two",
      "cause": "AK74",
      "weaponId": "AK74",
      "mapName": "north-america",
      "matchId": "9103",
      "distance": 1800,
      "eventTime": 1799695860,
      "contextTags": []
    },
    {
      "id": "sandbox-9103-4",
      "type": "player_killed",
      "sequence": 4,
      "at": "2027-01-11T19:38:00.000Z",
      "victimSteamId": "76561190000000002",
      "victimName": "Sandbox Two",
      "killerSteamId": "76561190000000004",
      "killerName": "Sandbox Four",
      "cause": "M4A1",
      "weaponId": "M4A1",
      "mapName": "north-america",
      "matchId": "9103",
      "distance": 7700,
      "eventTime": 1799696280,
      "contextTags": []
    }
  ],
  "scores": [],
  "notice": "Built by the league from the server's live feed."
}
Fields of the answer (35)
id
string The file’s id
map
string The map
startedAt
string (date-time) The first event. UTC, ISO 8601
endedAt
string (date-time), may be null When the game said the match ended; null when it did not. UTC, ISO 8601
reason
string, may be null Why it started; usually null
endReason
string, may be null How it ended, when the game said
coverage
string "observed": built by the league from the live feed, so its end and any final score are unconfirmed
eventCount
integer Number of events
events
array of object Every kill, suicide and death, in order
events[].id
string The game’s id for the event
events[].type
string A kill, a suicide, or a death with no killer
events[].sequence
integer Position in the file, from 0
events[].at
string (date-time) When it happened. UTC, ISO 8601
events[].victimSteamId
string SteamID64 of the player who died
events[].victimName
string, may be absent Their name in the game
events[].victimFaction
string, may be absent Their faction, when the server said
events[].killerSteamId
string, may be absent SteamID64 of the killer; absent for a death
events[].killerName
string, may be absent The killer’s name in the game
events[].killerFaction
string, may be absent The killer’s faction, when the server said
events[].cause
string, may be absent What killed them, as the game names it
events[].weaponId
string, may be absent The weapon, when the cause is one
events[].mapName
string The map the game reported
events[].matchId
string The game’s own match id: not one of ours
events[].distance
number, may be absent Kill distance in centimetres, when the game said
events[].eventTime
integer The game’s time for it, seconds since 1970
events[].contextTags
array of string The game’s tags, such as headshot
scores
array of object Running faction scores; empty when the feed carried none
scores[].sequence
integer Position, from 0
scores[].observedAt
string (date-time) When it was seen. UTC, ISO 8601
scores[].map
string The map
scores[].scores
array of object One entry per faction
scores[].scores[].name
string Faction name
scores[].scores[].score
number Its score
scores[].scores[].color
string Its colour
notice
string, may be null A note about how the file was made

GET /api/v1/team/elo

The Elo Rating now and over time. Scope: elo.read (Elo Rating).

Query parameters, all optional

limit
integer How many, up to 100
Request, curl
curl "https://gwl.gg/api/v1/team/elo?limit=5" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "eloRating": 1482,
  "ratedMatches": 12,
  "changeLast5": 14,
  "history": [
    1470,
    1468,
    1485,
    1482,
    1482
  ]
}
Fields of the answer (4)
eloRating
integer The Elo Rating: one ongoing all-time number, as on every page
ratedMatches
integer Rated matches, all time
changeLast5
number Elo change over the last five rated matches
history
array of number The Elo Rating after each rated match, oldest first

GET /api/v1/team/slots

The team’s open slots. Scope: slots.read (Open slots).

Request, curl
curl "https://gwl.gg/api/v1/team/slots" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "slots": [
    {
      "id": "test-slot-01",
      "startsAt": "2027-01-18T19:00:00.000Z",
      "region": "EU",
      "map": "sabatulo",
      "layer": "Default",
      "weather": "fog",
      "seatsFilled": 1,
      "host": "test-team",
      "joinedTeam": null
    },
    {
      "id": "test-slot-02",
      "startsAt": "2027-01-21T19:00:00.000Z",
      "region": "EU",
      "map": "europe",
      "layer": "Church",
      "weather": null,
      "seatsFilled": 2,
      "host": "stub-strikers",
      "joinedTeam": "test-team"
    }
  ]
}
Fields of the answer (10)
slots
array of object Open slots the team posted or joined, soonest first
slots[].id
string Slot id; /matches?slot=<id> on the site
slots[].startsAt
string (date-time) When the match would start. UTC, ISO 8601
slots[].region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
slots[].map
string Map id, or random
slots[].layer
string, may be null Zone name; null for none
slots[].weather
string, may be null Weather key (clear, overcast, rain, fog, storm), or null for any
slots[].seatsFilled
integer Teams in it so far, of three
slots[].host
string Slug of the team that posted it
slots[].joinedTeam
string, may be null Slug of the second team; null while that seat is free

Public routes

A personal key, or a test key with the Public league data scope.

GET /api/v1/standings

The league table. Scope: public.read (Public league data).

Query parameters, all optional

period
string season (the Friendly League) or all-time
region
string all, or one region code
limit
integer Page size, up to 50
page
integer Page, up to 10
Request, curl
curl "https://gwl.gg/api/v1/standings?period=season&region=all&limit=3" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "items": [
    {
      "rank": 1,
      "team": "fixture-falcons",
      "name": "Fixture Falcons",
      "tag": "FIXT",
      "region": "MEA",
      "played": 6,
      "wins": 4,
      "placements": {
        "first": 4,
        "second": 2,
        "third": 0
      },
      "score": 524,
      "eloRating": 1554,
      "form": [
        1,
        2,
        1,
        2,
        1
      ],
      "reputation": 86,
      "mainFaction": "lonestar"
    },
    {
      "rank": 2,
      "team": "lorem-lancers",
      "name": "Lorem Lancers",
      "tag": "LORM",
      "region": "NA",
      "played": 7,
      "wins": 4,
      "placements": {
        "first": 4,
        "second": 1,
        "third": 2
      },
      "score": 545,
      "eloRating": 1546,
      "form": [
        3,
        3,
        1,
        1,
        1
      ],
      "reputation": 68,
      "mainFaction": "lonestar"
    },
    {
      "rank": 3,
      "team": "placeholder-pioneers",
      "name": "Placeholder Pioneers",
      "tag": "PLCH",
      "region": "OCE",
      "played": 8,
      "wins": 2,
      "placements": {
        "first": 2,
        "second": 2,
        "third": 4
      },
      "score": 476,
      "eloRating": 1458,
      "form": [
        3,
        3,
        3,
        1,
        3
      ],
      "reputation": 81,
      "mainFaction": "manticore"
    }
  ],
  "page": 1,
  "limit": 3,
  "total": 10,
  "hasMore": true
}
Fields of the answer (21)
items
array of object This page
items[].rank
integer Place in this table
items[].team
string The team’s address on the site (/teams/<slug>): its id here
items[].name
string Team name
items[].tag
string Team tag
items[].region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
items[].played
integer Matches played in the period
items[].wins
integer 1st places in the period
items[].placements
object How often the team finished 1st, 2nd and 3rd
items[].placements.first
integer Times finished 1st
items[].placements.second
integer Times finished 2nd
items[].placements.third
integer Times finished 3rd
items[].score
number In-game score summed over the period
items[].eloRating
integer The Elo Rating: one ongoing all-time number, as on every page
items[].form
array of integer Last five finishes, oldest first
items[].reputation
number Reputation, 0 to 100
items[].mainFaction
string, may be null Faction code the team played most; null when none
page
integer This page’s number, from 1
limit
integer Page size asked for
total
integer How many there are in all
hasMore
boolean Whether there is a next page

GET /api/v1/teams

Every active team. Scope: public.read (Public league data).

Query parameters, all optional

limit
integer Page size, up to 50
page
integer Page, up to 10
Request, curl
curl "https://gwl.gg/api/v1/teams?limit=2" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "items": [
    {
      "slug": "stub-strikers",
      "name": "Stub Strikers",
      "tag": "STUB",
      "region": "EU",
      "flag": "PL",
      "flags": [
        "PL"
      ],
      "eloRating": 1645,
      "reputationScore": 82,
      "safetyBand": "Excellent",
      "provisional": false,
      "ratedMatches": 18,
      "seasonMatches": 5,
      "placements": {
        "first": 10,
        "second": 7,
        "third": 1
      },
      "rosterCount": 3,
      "mainFaction": "valkyra",
      "openSlots": 0,
      "rank": 1
    },
    {
      "slug": "fixture-falcons",
      "name": "Fixture Falcons",
      "tag": "FIXT",
      "region": "MEA",
      "flag": "ZA",
      "flags": [
        "ZA"
      ],
      "eloRating": 1554,
      "reputationScore": 86,
      "safetyBand": "Fair",
      "provisional": false,
      "ratedMatches": 10,
      "seasonMatches": 6,
      "placements": {
        "first": 5,
        "second": 4,
        "third": 1
      },
      "rosterCount": 3,
      "mainFaction": "lonestar",
      "openSlots": 2,
      "rank": 2
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 10,
  "hasMore": true
}
Fields of the answer (25)
items
array of object This page
items[].slug
string The team’s address on the site (/teams/<slug>): its id here
items[].name
string Team name
items[].tag
string Team tag
items[].region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
items[].flag
string, may be null The team’s primary flag, the one lists show: an ISO country code (GB, DE) or region:<code> for a region flag; null when none is chosen
items[].flags
array of string The team’s profile flags in order, primary first, up to three: each an ISO country code (GB, DE) or region:<code> for a region flag; empty when none is chosen
items[].eloRating
integer The Elo Rating: one ongoing all-time number, as on every page
items[].reputationScore
number Reputation, 0 to 100
items[].safetyBand
string Excellent, Good, Fair or Poor: the band of the Safety part of the reputation score
items[].provisional
boolean Too few rated matches for the reputation to settle
items[].ratedMatches
integer Rated matches, all time
items[].seasonMatches
integer Matches this season
items[].placements
object How often the team finished 1st, 2nd and 3rd
items[].placements.first
integer Times finished 1st
items[].placements.second
integer Times finished 2nd
items[].placements.third
integer Times finished 3rd
items[].rosterCount
integer People on the active roster
items[].mainFaction
string, may be null Faction code the team played most; null when none
items[].openSlots
integer Open slots it has posted or joined
items[].rank
integer, may be null Place in the Elo Global Rankings; null when unranked
page
integer This page’s number, from 1
limit
integer Page size asked for
total
integer How many there are in all
hasMore
boolean Whether there is a next page

GET /api/v1/teams/{slug}

One team’s public page. Scope: public.read (Public league data).

Request, curl
curl "https://gwl.gg/api/v1/teams/test-team" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "slug": "test-team",
  "name": "Test Team",
  "tag": "TEST",
  "region": "EU",
  "description": "An invented team for building against the API. Nothing here is real.",
  "flag": "GB",
  "flags": [
    "GB"
  ],
  "eloRating": 1482,
  "ratedMatches": 12,
  "placements": {
    "first": 2,
    "second": 7,
    "third": 3
  },
  "reputationScore": 79,
  "safetyBand": "Excellent",
  "rosterCount": 8,
  "rank": 6,
  "founders": [
    "Ada Example",
    "Bram Sample"
  ],
  "roster": [
    {
      "name": "Ada Example",
      "role": "owner",
      "playerId": "test-player-01",
      "country": "GB"
    },
    {
      "name": "Bram Sample",
      "role": "manager",
      "playerId": "test-player-02",
      "country": "NL"
    },
    {
      "name": "Cleo Placeholder",
      "role": "manager",
      "playerId": "test-player-03",
      "country": "FR"
    },
    {
      "name": "Dmitri Mock",
      "role": "player",
      "playerId": "test-player-04",
      "country": "PL"
    },
    {
      "name": "Eun-ji Testcase",
      "role": "player",
      "playerId": "test-player-05",
      "country": "KR"
    },
    {
      "name": "Femi Dummy",
      "role": "player",
      "playerId": "test-player-06",
      "country": "NG"
    },
    {
      "name": "Gustav Stub",
      "role": "player",
      "playerId": "test-player-07"
    },
    {
      "name": "Hana Fixture",
      "role": "player",
      "playerId": "test-player-08",
      "country": "JP"
    }
  ]
}
Fields of the answer (23)
slug
string The team’s address on the site (/teams/<slug>): its id here
name
string Team name
tag
string Team tag
region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
description
string What the team wrote about itself; may be empty
flag
string, may be null The team’s primary flag, the one lists show: an ISO country code (GB, DE) or region:<code> for a region flag; null when none is chosen
flags
array of string The team’s profile flags in order, primary first, up to three: each an ISO country code (GB, DE) or region:<code> for a region flag; empty when none is chosen
eloRating
integer The Elo Rating: one ongoing all-time number, as on every page
ratedMatches
integer Rated matches, all time
placements
object How often the team finished 1st, 2nd and 3rd
placements.first
integer Times finished 1st
placements.second
integer Times finished 2nd
placements.third
integer Times finished 3rd
reputationScore
number Reputation, 0 to 100
safetyBand
string Excellent, Good, Fair or Poor: the band of the Safety part of the reputation score
rosterCount
integer People on the active roster
rank
integer, may be null Place in the league table; null when unranked
founders
array of string Names of the Team Leader and Co-founders, Leader first
roster
array of object The public roster
roster[].name
string Display name
roster[].role
string owner (Team Leader), manager (Team Rep) or player
roster[].playerId
string, may be absent Their player page id (/players/<id>), when they have one
roster[].country
string, may be absent ISO 3166-1 alpha-2 country the person chose to show

GET /api/v1/matches

Upcoming matches or results. Scope: public.read (Public league data).

Query parameters, all optional

status
string upcoming, or results (newest first)
limit
integer Page size, up to 50
page
integer Page, up to 10
Request, curl
curl "https://gwl.gg/api/v1/matches?status=results&limit=2" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "items": [
    {
      "number": "9090",
      "status": "confirmed",
      "rated": true,
      "region": "EU",
      "map": "kavkazi",
      "layer": "Default",
      "weather": null,
      "season": "Sandbox Season",
      "startsAt": "2027-01-13T19:00:00.000Z",
      "concludedAt": "2027-01-13T21:57:00.000Z",
      "durationSeconds": 3420,
      "host": "example-eagles",
      "sides": [
        {
          "team": {
            "slug": "example-eagles",
            "name": "Example Eagles",
            "tag": "EXEG"
          },
          "faction": "lonestar",
          "score": 100,
          "placement": 1,
          "points": 3,
          "eloDelta": 15
        },
        {
          "team": {
            "slug": "mock-mortars",
            "name": "Mock Mortars",
            "tag": "MOCK"
          },
          "faction": "valkyra",
          "score": 72,
          "placement": 2,
          "points": 2,
          "eloDelta": 6
        },
        {
          "team": {
            "slug": "stub-strikers",
            "name": "Stub Strikers",
            "tag": "STUB"
          },
          "faction": "manticore",
          "score": 41,
          "placement": 3,
          "points": 1,
          "eloDelta": -17
        }
      ]
    },
    {
      "number": "9089",
      "status": "confirmed",
      "rated": true,
      "region": "EU",
      "map": "europe",
      "layer": "Default",
      "weather": null,
      "season": "Sandbox Season",
      "startsAt": "2027-01-12T07:00:00.000Z",
      "concludedAt": "2027-01-12T09:58:30.000Z",
      "durationSeconds": 3510,
      "host": "sample-sappers",
      "sides": [
        {
          "team": {
            "slug": "sample-sappers",
            "name": "Sample Sappers",
            "tag": "SMPL"
          },
          "faction": "lonestar",
          "score": 100,
          "placement": 1,
          "points": 3,
          "eloDelta": 14
        },
        {
          "team": {
            "slug": "placeholder-pioneers",
            "name": "Placeholder Pioneers",
            "tag": "PLCH"
          },
          "faction": "valkyra",
          "score": 61,
          "placement": 2,
          "points": 2,
          "eloDelta": 0
        },
        {
          "team": {
            "slug": "fixture-falcons",
            "name": "Fixture Falcons",
            "tag": "FIXT"
          },
          "faction": "manticore",
          "score": 29,
          "placement": 3,
          "points": 1,
          "eloDelta": -16
        }
      ]
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 11,
  "hasMore": true
}
Fields of the answer (27)
items
array of object This page
items[].number
string The match number, as on the website
items[].status
string scheduled (locked, not played), reported (result in, waiting), confirmed or disputed
items[].rated
boolean Whether the result has moved Elo
items[].region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
items[].map
string Map id: kavkazi, europe, north-america or sabatulo
items[].layer
string, may be null Zone name on that map; null for Random or none
items[].weather
string, may be null Weather key (clear, overcast, rain, fog, storm), or null for any
items[].season
string Name of the season the match belongs to
items[].startsAt
string (date-time) When it starts. UTC, ISO 8601
items[].concludedAt
string (date-time), may be null When the result was confirmed; null before. UTC, ISO 8601
items[].durationSeconds
integer, may be null How long it was played, in seconds; null when unknown
items[].host
string Team slug of the host
items[].sides
array of object The three teams, host first
items[].sides[].team
object A team, by slug, name and tag
items[].sides[].team.slug
string The team’s address on the site (/teams/<slug>): its id here
items[].sides[].team.name
string, may be null Team name; null if it is gone
items[].sides[].team.tag
string, may be null Team tag; null if it is gone
items[].sides[].faction
string, may be null Faction code once a moderator assigns one, else null
items[].sides[].score
number, may be null The side’s in-game score, 0 to 100; null before a result
items[].sides[].placement
integer, may be null 1, 2 or 3; null before a result
items[].sides[].points
number, may be null Placement points for the match: 3 for 1st, 2 for 2nd, 1 for 3rd
items[].sides[].eloDelta
number, may be null Elo change from this match; null until it is rated
page
integer This page’s number, from 1
limit
integer Page size asked for
total
integer How many there are in all
hasMore
boolean Whether there is a next page

GET /api/v1/players/leaderboard

The player leaderboard. Scope: public.read (Public league data).

Query parameters, all optional

limit
integer Page size, up to 50
page
integer Page, up to 10
Request, curl
curl "https://gwl.gg/api/v1/players/leaderboard?limit=3" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "items": [
    {
      "rank": 1,
      "playerId": "test-player-53",
      "name": "Bea Sapper",
      "team": {
        "slug": "sample-sappers",
        "name": "Sample Sappers",
        "tag": "SMPL"
      },
      "region": "EU",
      "eloRating": 1708,
      "matches": 28,
      "wins": 9,
      "winRate": 0.321,
      "country": "DE"
    },
    {
      "rank": 2,
      "playerId": "test-player-58",
      "name": "Bea Mortar",
      "team": {
        "slug": "mock-mortars",
        "name": "Mock Mortars",
        "tag": "MOCK"
      },
      "region": "ASIA",
      "eloRating": 1695,
      "matches": 17,
      "wins": 9,
      "winRate": 0.529
    },
    {
      "rank": 3,
      "playerId": "test-player-64",
      "name": "Dana Dragoon",
      "team": {
        "slug": "dummy-dragoons",
        "name": "Dummy Dragoons",
        "tag": "DUMY"
      },
      "region": "SA",
      "eloRating": 1682,
      "matches": 3,
      "wins": 1,
      "winRate": 0.333
    }
  ],
  "page": 1,
  "limit": 3,
  "total": 34,
  "hasMore": true
}
Fields of the answer (18)
items
array of object This page
items[].rank
integer, may be null Place on the leaderboard; null before a rated match
items[].playerId
string Player page id (/players/<id>)
items[].name
string Display name
items[].team
object Their team
items[].team.slug
string The team’s address on the site (/teams/<slug>): its id here
items[].team.name
string Team name
items[].team.tag
string Team tag
items[].region
string Competitive region code: EU, NA, SA, ASIA, OCE or MEA
items[].eloRating
integer The player’s Elo Rating
items[].matches
integer Rated matches played
items[].wins
integer 1st places
items[].winRate
number, may be null Wins divided by matches, 0 to 1; null before a match
items[].country
string, may be absent ISO 3166-1 alpha-2 country the person chose to show
page
integer This page’s number, from 1
limit
integer Page size asked for
total
integer How many there are in all
hasMore
boolean Whether there is a next page

Test mode routes

Test keys only. A live key gets 404.

GET /api/v1/test/scenarios

The sandbox’s scenarios and forced errors. No scope: any test key.

Test keys only; a live key gets 404. Pass a scenario as ?scenario=<name> on any read, and ?force_error=<code> to get that error.

Request, curl
curl "https://gwl.gg/api/v1/test/scenarios" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "scenarios": [
    {
      "name": "default",
      "description": "Test Team with 8 members, 2 upcoming and 3 recent matches, 2 applications and 2 open slots. Used when no scenario is given."
    },
    {
      "name": "empty-team",
      "description": "A team made today: only its Team Leader, no matches, applications, slots or Elo history, and no rank."
    },
    {
      "name": "busy-week",
      "description": "A busy week: 7 upcoming and 4 recent matches (one disputed), 6 applications and 5 open slots."
    },
    {
      "name": "full-roster",
      "description": "The default team with a full roster of 32."
    },
    {
      "name": "errors",
      "description": "Every call answers an error: the one named by force_error, or internal_error without it."
    }
  ],
  "forceErrors": [
    {
      "code": "invalid_request",
      "status": 400
    },
    {
      "code": "invalid_json",
      "status": 400
    },
    {
      "code": "missing_key",
      "status": 401
    },
    {
      "code": "invalid_key",
      "status": 401
    },
    {
      "code": "key_revoked",
      "status": 401
    },
    {
      "code": "key_expired",
      "status": 401
    },
    {
      "code": "missing_scope",
      "status": 403
    },
    {
      "code": "scope_lost",
      "status": 403
    },
    {
      "code": "wrong_key_type",
      "status": 403
    },
    {
      "code": "team_suspended",
      "status": 403
    },
    {
      "code": "key_maker_left",
      "status": 403
    },
    {
      "code": "key_maker_no_access",
      "status": 403
    },
    {
      "code": "not_found",
      "status": 404
    },
    {
      "code": "method_not_allowed",
      "status": 405
    },
    {
      "code": "application_closed",
      "status": 409
    },
    {
      "code": "body_too_large",
      "status": 413
    },
    {
      "code": "unsupported_media_type",
      "status": 415
    },
    {
      "code": "rate_limited",
      "status": 429
    },
    {
      "code": "daily_limit",
      "status": 429
    },
    {
      "code": "too_many_bad_keys",
      "status": 429
    },
    {
      "code": "internal_error",
      "status": 500
    },
    {
      "code": "public_api_off",
      "status": 503
    }
  ]
}
Fields of the answer (6)
scenarios
array of object Every scenario
scenarios[].name
string Pass it as ?scenario=<name>
scenarios[].description
string What the sandbox answers in it
forceErrors
array of object Every error code force_error can produce
forceErrors[].code
string Pass it as ?force_error=<code>
forceErrors[].status
integer The HTTP status it answers with

POST /api/v1/test/reset

Forget this test key’s answers to applications. No scope: any test key.

Test keys only; a live key gets 404. The sandbox also forgets them by itself 10 minutes after the first answer.

Request, curl
curl -X POST "https://gwl.gg/api/v1/test/reset" \
  -H "Authorization: Bearer $GWL_API_KEY"
Example answer, 200
{
  "reset": true
}
Fields of the answer (1)
reset
boolean Always true

The OpenAPI document

GET /api/v1/openapi.json

This document. No key needed.

Request, curl
curl "https://gwl.gg/api/v1/openapi.json"

Next