POST
https://api.dev.bifrostgaming.com/v1/graphqlguildGetMatches
v1Get recent match history for a game server, including map, mode, scores, and player counts.
Operation Type
Query
Rate Limit: 1 request per 30 minutes per server
Returns large result sets; cache locally between requests.
Input Fields
| Field | Type | Required | Description |
|---|---|---|---|
serverId | ID! | Required | The unique identifier of the game server. |
gameType | String | Optional | The game type identifier. |
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!, $gameType: String) { guildGetMatches(serverId: $serverId, gameType: $gameType) { matches { matchId mapName gameMode team1Score team2Score matchStartTime matchEndTime playerCount } } }",
"variables": { "serverId": "YOUR_SERVER_ID", "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
.jsonfile, 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": {
"guildGetMatches": {
"matches": [
{
"matchId": "match-abc-123",
"mapName": "Hurtgen Forest",
"gameMode": "Warfare",
"team1Score": 5,
"team2Score": 0,
"matchStartTime": "2025-01-15T10:00:00Z",
"matchEndTime": "2025-01-15T11:30:00Z",
"playerCount": 100
},
{
"matchId": "match-def-456",
"mapName": "Carentan",
"gameMode": "Offensive",
"team1Score": 3,
"team2Score": 2,
"matchStartTime": "2025-01-15T08:00:00Z",
"matchEndTime": "2025-01-15T09:25:00Z",
"playerCount": 94
}
]
}
}
}Error Responses
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
matches | Array | Optional | Array of match objects with: matchId, mapName, gameMode, team1Score, team2Score, matchStartTime, matchEndTime, playerCount |
