Venice Unleashed
Deprecation and retirement of v1 API
Version 1 of the API will be deprecated on January 1, 2026. Please migrate to version 2.
Venice Unleashed endpoints are available at https://api.bflist.io/vu/v1
.
Missing servers
We're currently unable to query all Venice Unleashed servers due to issues with how some servers are hosted. As a result, we don't offer a livestats endpoint for VU.
If you'd like to get your server listed, please see our FAQ entry on getting your server added.
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.
GET /servers/:page
Response
200 OK
X-Total-Pages: 1
[
{
"guid": "0dc46531b1f24006895ab75eff1bb102",
"ip": "124.221.143.18",
"port": 25200,
"name": "VU Genshin Impact Server +qq qun:725062034",
"numPlayers": 32,
"maxPlayers": 69,
"map": "XP4_FD",
"mapLabel": "Markaz Monolith",
"gameType": "ConquestSmall",
"roundsPlayed": 0,
"roundsTotal": 1,
"targetScore": 0,
"password": false,
"uptime": 53566,
"roundTime": 1738,
"region": "EU",
"country": "NL",
"pingSite": "iad",
"version": "20079",
"teams": [
{
"tickets": 411.668091
},
{
"tickets": 181.611679
}
],
"players": [
{
"name": "AUVzuiyouzi",
"team": 1,
"squad": 1,
"squadLabel": "Alpha",
"kills": 17,
"deaths": 7,
"score": 3059,
"ping": 12
},
// 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 (gameExpansions, extendedInfo, settings, maps, slots, 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": "30d77c27c80f4a118a4f1f2121890b11",
"ip": "139.226.28.246",
"port": 25201,
"name": "Springfield Bakery Alpha Testing (PVP Allowed,Q:459893774)",
"numPlayers": 64,
"maxPlayers": 127,
"map": "MP_018",
"mapLabel": "Kharg Island",
"gameType": "RushLarge",
"roundsPlayed": 0,
"roundsTotal": 1,
"targetScore": 0,
"password": false,
"uptime": 551978,
"roundTime": 1482,
"region": "EU",
"country": "NL",
"pingSite": "iad",
"version": "20079",
"teams": [
{
"tickets": 160
},
{
"tickets": 2945
}
],
"players": [
{
"name": "JOZOULE",
"team": 1,
"squad": 1,
"squadLabel": "Alpha",
"kills": 0,
"deaths": 0,
"score": 0,
"ping": 54
},
// 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": "AUVzuiyouzi",
"team": 1,
"squad": 1,
"squadLabel": "Alpha",
"kills": 20,
"deaths": 7,
"score": 3439,
"ping": 21
}
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.