POST
https://api.dev.bifrostgaming.com/v1/graphqlguildGetPlayerHistory
v1Get a player's session history, including connections, disconnections, and name changes.
Operation Type
Query
Rate Limit: 1 request per 30 minutes per playerId per server
Returns large result sets; cache locally between requests.
Input Fields
| Field | Type | Required | Description |
|---|---|---|---|
serverId | ID! | Required | The server ID to query. |
playerId | String! | Required | Player's Steam ID. |
gameType | String | Optional | Game type identifier (e.g. "HLL"). |
Code Examples
curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
"query": "query GuildGetPlayerHistory($serverId: ID!, $playerId: String!, $gameType: String) { guildGetPlayerHistory(serverId: $serverId, playerId: $playerId, gameType: $gameType) { history { action timestamp data } } }",
"variables": {
"serverId": "YOUR_SERVER_ID",
"playerId": "76561198000000000",
"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": {
"guildGetPlayerHistory": {
"history": [
{ "action": "CONNECTED", "timestamp": "2025-01-15T10:00:00Z", "data": null },
{ "action": "TEAM_SWITCH", "timestamp": "2025-01-15T10:15:00Z", "data": "Allies -> Axis" },
{ "action": "DISCONNECTED", "timestamp": "2025-01-15T11:30:00Z", "data": null }
]
}
}
}
