Search Ragnarok Bans — partnerSearchRagnarokBans

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

partnerSearchRagnarokBans

Look up a single Ragnarok ban by either its UUID (RagnarokBanId) or its appeal code (RagnarokBanAppealCode). Returns the matching ban regardless of status — useful when handling appeals from players who only have the RK-XXXXXX code, or when verifying a previously-issued ban by id.

Operation Type

Query

Rate Limit: 60 requests / 60 seconds per partner

Important usage notes

Provide exactly one of ragnarokBanId or ragnarokBanAppealCode. Passing both, or neither, returns a 400 error.
Returns null (not an error) if no row matches the supplied identifier.
Unlike partnerGetRagnarokBans, this endpoint returns bans regardless of status — INACTIVE (removed) bans are still searchable here so appeals can be reviewed.
guildId on the returned ban is null when the originating community is not on the Bifrost system (typical for BARRICADE imports). The community is then identified by playerBanGuildName / playerBanGuildDiscord.
playerBanPlatform is always present and is either "PC" or "CONSOLE".

Input Fields

Field	Type	Required	Description
`partnerId`	String!	Required	Your unique partner identifier.
`partnerEncryptionKey`	String!	Required	Your partner encryption key (Base64-encoded).
`ragnarokBanId`	String	Optional	The UUID of the ban to look up. Provide exactly one of ragnarokBanId or ragnarokBanAppealCode.
`ragnarokBanAppealCode`	String	Optional	The RK-XXXXXX appeal code to look up. Provide exactly one of ragnarokBanId or ragnarokBanAppealCode.

Code Examples

curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query PartnerSearchRagnarokBans($partnerId: String!, $partnerEncryptionKey: String!, $ragnarokBanAppealCode: String) { partnerSearchRagnarokBans(partnerId: $partnerId, partnerEncryptionKey: $partnerEncryptionKey, ragnarokBanAppealCode: $ragnarokBanAppealCode) { ragnarokBanId ragnarokBanAppealCode playerId playerBanCategory playerBanReason playerBanStatus playerBanEvidence createdAt updatedAt removeBanReason } }",
    "variables": {
      "partnerId": "your-partner-id",
      "partnerEncryptionKey": "your-base64-encryption-key",
      "ragnarokBanAppealCode": "RK-K4M9Q2"
    }
  }'

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": {
    "partnerSearchRagnarokBans": {
      "ragnarokBanId": "9c54e3a2-7f8d-4a1b-9c2e-6a5d4e3f2b1c",
      "ragnarokBanAppealCode": "RK-K4M9Q2",
      "guildId": null,
      "playerBanGuildName": "Some Community Not On Bifrost",
      "playerBanGuildDiscord": "https://discord.gg/example",
      "playerId": "76561198000000000",
      "playerEosId": null,
      "playerName": "Mutapalli010",
      "playerBanType": "PERMANENT",
      "playerBanCategory": "RACISM",
      "playerBanPlatform": "PC",
      "playerBanReason": "Repeated racial slurs in team chat across multiple sessions.",
      "playerBanEvidence": ["https://example.com/evidence/clip.mp4"],
      "playerBanSource": "BARRICADE",
      "playerBanStatus": "ACTIVE",
      "removeBanReason": null,
      "createdAt": "2026-04-07T14:32:18.491Z",
      "updatedAt": "2026-04-07T14:32:18.491Z"
    }
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`PartnerRagnarokBan`	PartnerRagnarokBan	Optional	The matching ban record (full detail), or null if no row matches the supplied identifier.

A Shrapnelworks product