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).
curl "https://gwl.gg/api/v1/team" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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.
curl "https://gwl.gg/api/v1/team/members" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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.
curl "https://gwl.gg/api/v1/team/applications" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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
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}'{
"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
curl "https://gwl.gg/api/v1/team/fixtures?limit=2" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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).
curl "https://gwl.gg/api/v1/team/matches/9103" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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.
curl "https://gwl.gg/api/v1/team/matches/9103/file" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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
curl "https://gwl.gg/api/v1/team/elo?limit=5" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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).
curl "https://gwl.gg/api/v1/team/slots" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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
curl "https://gwl.gg/api/v1/standings?period=season®ion=all&limit=3" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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
curl "https://gwl.gg/api/v1/teams?limit=2" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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).
curl "https://gwl.gg/api/v1/teams/test-team" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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
curl "https://gwl.gg/api/v1/matches?status=results&limit=2" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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
curl "https://gwl.gg/api/v1/players/leaderboard?limit=3" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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.
curl "https://gwl.gg/api/v1/test/scenarios" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"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.
curl -X POST "https://gwl.gg/api/v1/test/reset" \ -H "Authorization: Bearer $GWL_API_KEY"
{
"reset": true
}Fields of the answer (1)
- reset
- boolean Always true
The OpenAPI document
GET /api/v1/openapi.json
This document. No key needed.
curl "https://gwl.gg/api/v1/openapi.json"
