Get Rotation — guildGetServerRotation | Bifrost Developer Center

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

guildGetServerRotation

Get a game server's map rotation configurations, including which rotation is currently applied. Returns every active rotation config for the server; the one currently in effect is flagged with isActive and its name is also returned directly as activeRotationName.

Operation Type

Query

Rate Limit: 1 request per 60 seconds per server

Server rotation does not change frequently.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	The unique identifier of the game server.

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": "query ($serverId: ID!) { guildGetServerRotation(serverId: $serverId) { success activeRotationName totalCount rotations { id rotationName isActive maps { mapRconName mapFriendlyName gameMode mapImageUrl } } } }",
    "variables": { "serverId": "YOUR_SERVER_ID" }
  }'

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": {
    "guildGetServerRotation": {
      "success": true,
      "activeRotationName": "Main Warfare",
      "totalCount": 2,
      "rotations": [
        {
          "id": "rot_abc123",
          "rotationName": "Main Warfare",
          "isActive": true,
          "maps": [
            { "mapRconName": "hurtgenforest_warfare", "mapFriendlyName": "Hurtgen Forest", "gameMode": "Warfare", "mapImageUrl": "https://imagedelivery.net/.../public" },
            { "mapRconName": "foy_warfare", "mapFriendlyName": "Foy", "gameMode": "Warfare", "mapImageUrl": "https://imagedelivery.net/.../public" }
          ]
        },
        {
          "id": "rot_def456",
          "rotationName": "Night Offensive",
          "isActive": false,
          "maps": [
            { "mapRconName": "carentan_offensive_us", "mapFriendlyName": "Carentan", "gameMode": "Offensive", "mapImageUrl": "https://imagedelivery.net/.../public" }
          ]
        }
      ]
    }
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`success`	Boolean!	Required	Whether the request succeeded.
`activeRotationName`	String	Optional	Name of the rotation currently applied to the server (the rotation whose isActive flag is true), or null if no rotation is currently applied.
`rotations`	Array	Optional	All active rotation configurations for the server. Each entry has: id, rotationName, isActive (true for the rotation currently applied), and maps[] (each with mapRconName, mapFriendlyName, gameMode, mapImageUrl). Sorted with the active rotation first, then alphabetically.
`totalCount`	Int!	Required	Number of rotation configurations returned.
`serverId`	String!	Required	The server id the rotations belong to.
`error`	String	Optional	Error message when success is false; otherwise null.
`timestamp`	String!	Required	ISO-8601 timestamp of when the response was generated.

A Shrapnelworks product