POST
https://api.dev.bifrostgaming.com/v1/graphqlguildGetLogs
v1Get recent game event logs from a server, including kills, team kills, chat messages, kicks, and other actions.
Operation Type
Query
Rate Limit: 1 request per 15 seconds per server
Important usage notes
- Rate limited to 1 request per 15 seconds per server. If rate limited, the response includes a retry delay in the error field.
Input Fields
| Field | Type | Required | Description |
|---|---|---|---|
serverId | ID! | Required | Unique server identifier |
gameType | String | Optional | Game type filter (e.g., "HLL") |
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 GetLogs($serverId: ID!, $gameType: String) { guildGetLogs(serverId: $serverId, gameType: $gameType) { success totalCount logs { action timestamp data } error timestamp } }",
"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": {
"guildGetLogs": {
"logs": [
{
"type": "KILL",
"playerName": "SoldierOne",
"playerId": "76561198012345678",
"message": "SoldierOne killed EnemyPlayer with M1 GARAND",
"timestamp": "2025-01-15T10:32:15Z"
},
{
"type": "CHAT",
"playerName": "ChatPlayer",
"playerId": "76561198087654321",
"message": "[Team] Good game everyone",
"timestamp": "2025-01-15T10:31:45Z"
}
]
}
}
}Error Responses
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
success | Boolean | Optional | Whether the request succeeded |
totalCount | Int | Optional | Total number of log entries returned |
logs | Array | Optional | Array of log entries with action, timestamp, and data fields |
error | String | Optional | Error message if rate limited or failed |
timestamp | String | Optional | Server timestamp of the response |
