POST
https://api.dev.bifrostgaming.com/v1/graphqlguildGetPlayerVip
v1Check a player's VIP status across all servers in your guild. Returns all VIP entitlements for the given player.
Operation Type
Query
Rate Limit: 1 request per 60 seconds per playerId per guild
VIP status does not change frequently; cache results locally.
Input Fields
| Field | Type | Required | Description |
|---|---|---|---|
playerId | String! | Required | Player's unique identifier (e.g., Steam ID) |
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 { guildGetPlayerVip(playerId: \"PLAYER_STEAM_ID\") { success totalCount entitlements { id gameServerId serverName playerName vipDuration vipExpiresAt vipActive } timestamp } }"
}'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": {
"guildGetPlayerVip": {
"success": true,
"totalCount": 2,
"entitlements": [
{
"serverId": "server-abc-123",
"serverName": "My Community Server #1",
"isVip": true
},
{
"serverId": "server-def-456",
"serverName": "My Community Server #2",
"isVip": false
}
],
"timestamp": "2025-01-15T12:34:56.789Z"
}
}
}Error Responses
Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
success | Boolean | Optional | Whether the query succeeded |
totalCount | Int | Optional | Number of VIP entitlements found |
entitlements | Array | Optional | VIP entries with: id, gameServerId, serverName, playerName, vipDuration, vipExpiresAt, vipActive |
timestamp | String | Optional | ISO 8601 timestamp of the response |
