Get Servers — guildGetServers | Bifrost Developer Center

POSThttps://api.dev.bifrostgaming.com/v1/graphql

guildGetServers

Get a list of all active game servers associated with your guild. Used by the Discord bot during setup to let admins pick which server to enable map voting on.

Operation Type

Query

Rate Limit: 10 requests per minute per guild

Server list changes infrequently; cache locally after first request.

Important usage notes

This endpoint requires no input parameters — the guild is determined automatically from your OAuth token.
Only active servers are returned. If a server has been deactivated in the Bifrost control panel, it will not appear in the results.
The server id returned here is the same ID used in all other server-scoped API calls (guildGetGameState, guildGetServerRotation, guildSetNextMap, etc.).

Code Examples

curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ guildGetServers { success servers { id serverName gameType } totalCount error timestamp } }"
  }'

Postman Collection

Download a ready-to-use Postman collection for this endpoint. Import it into Postman to start testing immediately.

How to import into Postman

Open Postman and click Import (top-left)
Drag and drop the downloaded .json file, or click Upload Files and select it
Click Import to confirm
The collection appears in your sidebar — expand it and select the request
In the Body tab, update the placeholder values (your-partner-id, etc.) with your actual credentials
Click Send

The collection uses Postman's GraphQL body type, which provides syntax highlighting and variable editing. Make sure your Postman version is 7.2+ for GraphQL support.

Success Response200

{
  "data": {
    "guildGetServers": {
      "success": true,
      "servers": [
        {
          "id": "abc12345-def6-7890-abcd-ef1234567890",
          "serverName": "My HLL Server #1",
          "gameType": "HLL"
        },
        {
          "id": "fed98765-cba4-3210-fedc-ba9876543210",
          "serverName": "My HLL Server #2",
          "gameType": "HLL"
        }
      ],
      "totalCount": 2,
      "error": null,
      "timestamp": "2026-03-03T12:00:00.000Z"
    }
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`success`	Boolean!	Required	Whether the request succeeded.
`servers`	Array	Required	Array of server objects with id, serverName, and gameType.
`totalCount`	Int!	Required	Total number of servers returned.
`error`	String	Optional	Error message if the request failed.
`timestamp`	String!	Required	ISO 8601 timestamp of the response.

In partnership with

Brilliant game servers for communities large and small.

Get yours today!

A Shrapnelworks product