Skip to content

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.