Skip to main content

Get Guild Tournament Treasury

Retrieve the treasury for a guild tournament. Requires the guilds.owner permission.

Endpoint​

GET /api/v2/guild-tournaments/:id/treasury

Authentication​

This endpoint requires:

  1. JWT Token: User authentication
  2. Permission: guilds.owner role (you must own the guild that owns this tournament)
Authorization: Bearer user-jwt-token-here

Description​

Returns the treasury associated with a guild tournament. The treasury holds funds for prize distribution. Use this to verify the treasury is set up before launching.

Path Parameters​

ParameterTypeRequiredDescription
idstringYesGuild tournament ID

Request Example​

GET /api/v2/guild-tournaments/gt-123/treasury

Response​

Success Response (200)​

Returns the treasury object (structure varies by tournament configuration).

Error Response (401)​

{
  "message": "Unauthorized",
  "status": 401
}

Error Response (403)​

{
  "message": "Forbidden",
  "status": 403
}

Error Response (404)​

{
  "message": "Guild tournament not found",
  "status": 404
}

Usage Example​

const response = await fetch("https://api-stage.intraverse.io/api/v2/guild-tournaments/gt-123/treasury", {
  headers: {
    Authorization: `Bearer ${jwtToken}`,
  },
});

const treasury = await response.json();
console.log("Treasury:", treasury);

Next Steps​