Partner API: player counts by join code

For tools outside the bot, such as a seeding group that checks every 30 seconds who is on whose server. It only reads: player count, max players, map, mode and, where the community allows it, who is online.

Your key

Partner keys are given out by the WarDogs Server Commands team, one key per partner. It works for every server on the bot, so you do not need one per server. Keep it secret; if it leaks, ask for a new one.

The request

GET https://wardogsbot.com/api/partner/v1/servers?codes=JOINCODE_A,JOINCODE_B
Authorization: Bearer wdp_YOURKEY

• codes: the join codes of the servers (the Server ID you search in game), comma-separated, up to 100 per call
• One server only: /api/partner/v1/servers/JOINCODE_A
• At most 60 calls a minute per key: ask for all your servers in one call every 30 seconds

The answer

{
  "ok": true,
  "servers": [
    { "joinCode": "JOINCODE_A", "found": true, "online": true,
      "name": "Server name", "community": "Community name",
      "players": 90, "maxPlayers": 100, "map": "Ozeti",
      "updatedAt": "2026-09-19T01:29:52.000Z",
      "playersShared": true,
      "playerList": [{ "steamId": "7656119...", "name": "Player" }] },
    { "joinCode": "JOINCODE_B", "found": false }
  ]
}

playerList is only filled when that community switched on “Share the live player list with partner apps” (Dashboard → Settings → Public server browser, ST-10). Otherwise it is null and you get the count only. A server that is not connected to the bot comes back with found: false.

For server owners

Want a seeding group to see your server? Add the bot, and switch on the sharing option under Settings → Public server browser (ST-10) if they need to see who is online. It is off by default.