Banned Chat — guildGetBannedChat | Bifrost Developer Center

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

guildGetBannedChat

Retrieve chat messages that triggered banned word filters on a server.

Operation Type

Query

Rate Limit: 1 request per 5 minutes per server

Banned chat logs do not change frequently.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	The server ID to query.
`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 GuildGetBannedChat($serverId: ID!, $gameType: String) { guildGetBannedChat(serverId: $serverId, gameType: $gameType) { success totalMessages bannedWordsUsed messages { message playerName playerId logTime triggeredWords } cacheTTL } }",
    "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 .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": {
    "guildGetBannedChat": {
      "messages": [
        {
          "playerName": "ToxicPlayer",
          "playerId": "76561198012345678",
          "message": "[filtered content]",
          "timestamp": "2025-01-15T10:32:00Z",
          "triggeredWord": "***"
        }
      ]
    }
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`success`	Boolean	Required	Whether the request succeeded.
`totalMessages`	Int	Required	Total number of banned chat messages.
`bannedWordsUsed`	[String]	Required	Array of triggered banned words.
`messages`	[BannedChatMessage]	Required	Array of messages containing message, playerName, playerId, logTime, and triggeredWords.
`cacheTTL`	Int	Optional	Cache time-to-live in seconds.

In partnership with

Brilliant game servers for communities large and small.

Get yours today!

A Shrapnelworks product