Battlefield 1942
Battlefield 1942 endpoints are available at https://api.bflist.io/bf1942/v1/
.
Live stats#
Get the number of currently active players and servers in Battlefield 1942.
GET /livestats
Response
200 OK
{
"servers": 100,
"players": 226
}
Get a page from the list of servers#
Per default, we send 50 servers per page. You can set a custom page size betweeen 20 and 100 via an optional perPage
query parameter.
Since servers for older Battlefield games do not have a guid, one is generated using the server's ip and port. The generated guid is bflist-specific and neither known to nor returned by the server.
If a server's current mod is supported by the joinme.click launcher, the joinLink
-property will contain a URL to directly trigger the launcher. In environments which do not allow custom URL protocols (e.g. Discord, Twitch chat), use joinLinkWeb
instead. Users will be directed to the joinme.click website and can trigger the launcher from there. Note: Both properties will be null
for servers running mods not supported by joinme.click.
GET /servers/:page
Response
200 OK
X-Total-Pages: 2
[
{
"guid": "69545b0-16356cc-1f641a3-1ffb03",
"ip": "194.88.105.25",
"port": 14567,
"name": "SiMPLE | BF1942",
"numPlayers": 63,
"maxPlayers": 72,
"mapName": "bocage",
"password": false,
"gameType": "conquest",
"gameVersion": "v1.61",
"gameMode": "openplaying",
"averageFps": 0,
"contentCheck": false,
"dedicated": 2,
"gameId": "bf1942",
"mapId": "BF1942",
"reservedSlots": 0,
"roundTime": 2520,
"roundTimeRemain": 898,
"status": 4,
"anticheat": false,
"tickets1": 234,
"tickets2": 485,
"unpureMods": "",
"joinLink": "bf1942://194.88.105.25:14567",
"joinLinkWeb": "https://joinme.click/g/bf1942/194.88.105.25:14567",
"teams":
[
{
"index": 1,
"label": "Axis",
"tickets": 234
},
{
"index": 2,
"label": "Allied",
"tickets": 485
}
],
"players":
[
{
"name": "Mr.Nice Guy.",
"score": 8,
"kills": 11,
"deaths": 5,
"ping": 18,
"team": 2,
"teamLabel": "Allied"
},
// more players
]
},
// more servers
]
Get a server's details#
GET /servers/:ip::port
Note: You can also access each property individually. For example, GET /servers/:ip::port/name
will return only the server's name as plain text. Complex properties (teams, players) are returned as JSON. So, GET /servers/:ip::port/players
will return a JSON array of players on the server.
Response
200 OK
{
"guid": "118c300-651300-7fec0c-25885e3",
"ip": "78.46.52.115",
"port": 14567,
"name": "Badewiese [Public DC Server]",
"numPlayers": 2,
"maxPlayers": 48,
"mapName": "dc basrahs edge",
"password": false,
"gameType": "coop",
"gameVersion": "v1.612",
"gameMode": "pre",
"averageFps": 0,
"contentCheck": false,
"dedicated": 2,
"gameId": "desertcombat",
"mapId": "Desertcombat",
"reservedSlots": 0,
"roundTime": 2400,
"roundTimeRemain": 2400,
"status": 4,
"anticheat": false,
"tickets1": 900,
"tickets2": 900,
"unpureMods": "bf1918, dcfinal, desertcombat",
"joinLink": "bf1942://78.46.52.115:14567?mod=desertcombat",
"joinLinkWeb": "https://joinme.click/g/bf1942/78.46.52.115:14567?mod=desertcombat",
"teams": [
{
"index": 1,
"label": "Axis",
"tickets": 900
},
{
"index": 2,
"label": "Allied",
"tickets": 900
}
],
"players": [
{
"name": "POCTOB76",
"score": 0,
"kills": 0,
"deaths": 0,
"ping": 61,
"team": 1,
"teamLabel": "Axis"
},
// more players
]
}
Get a player's details#
GET /players/:name
Note: You can also access each property individually. For example, GET /players/:name/score
will return only the players's current score as plain text.
Response
200 OK
{
"name": "BLITZ",
"score": 0,
"kills": 0,
"deaths": 0,
"ping": 70,
"team": 1,
"teamLabel": "Axis"
}
Get a player's current server's details#
GET /players/:name/server
Please see the section on getting an individual server's details, as this endpoint's features and response structure are identical.