Get Live Server IDs — partnerGetLiveServerIds

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

partnerGetLiveServerIds

Returns all active server IDs for a given game type. Use these IDs with partnerGetLiveServerData to fetch real-time match data for each server. Supports cursor-based pagination with a maximum of 100 IDs per page.

Operation Type

Query

Rate Limit: No rate limit (testing)

Rate limiting is currently disabled during the testing phase. This will be enforced in production.

Important usage notes

This endpoint does NOT require an encrypted payload. Pass your partnerId and partnerEncryptionKey directly as query variables.
Returns all active server IDs for the specified game type, ordered alphabetically by UUID.
Use the returned server IDs with partnerGetLiveServerData to fetch real-time match data.
Maximum 100 server IDs per page. Use cursor-based pagination if there are more.
Rate limiting is currently disabled during the testing phase.

Input Fields

Field	Type	Required	Description
`partnerId`	String!	Required	Your unique partner identifier, provided when your partner account was created.
`partnerEncryptionKey`	String!	Required	Your partner encryption key (Base64-encoded). Used to verify your identity.
`gameType`	String!	Required	The game type code to query servers for (e.g. "HLL" for Hell Let Loose).
`limit`	Int	Optional	Maximum number of server IDs to return per page. Default and maximum: 100.
`cursor`	String	Optional	Pagination cursor. Pass the nextCursor value from the previous response to get the next page. Omit for the first page.

Code Examples

# Get all active server IDs for HLL
curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query PartnerGetLiveServerIds($partnerId: String!, $partnerEncryptionKey: String!, $gameType: String!) { partnerGetLiveServerIds(partnerId: $partnerId, partnerEncryptionKey: $partnerEncryptionKey, gameType: $gameType) { gameType serverIds hasMore nextCursor } }",
    "variables": {
      "partnerId": "your-partner-id",
      "partnerEncryptionKey": "your-base64-encryption-key",
      "gameType": "HLL"
    }
  }'

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": {
    "partnerGetLiveServerIds": {
      "gameType": "HLL",
      "serverIds": [
        "30260a91-7d66-4006-a4ec-cb8122d70236",
        "54eea112-2655-4b78-a3f8-cc738fd8a008",
        "f90167a4-6b2f-4a3d-bb1c-aee247041afb"
      ],
      "hasMore": false,
      "nextCursor": null
    }
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`gameType`	String	Required	The game type that was queried.
`serverIds`	[String]	Required	Array of server UUID identifiers. Use these with partnerGetLiveServerData.
`nextCursor`	String	Optional	Pagination cursor for the next page. Null when there are no more results.
`hasMore`	Boolean	Required	True if there are more server IDs beyond this page.

In partnership with

Brilliant game servers for communities large and small.

Get yours today!

A Shrapnelworks product