Skip to main content

Get User Score

Retrieve a user's game score for a specific round.

Endpoint

GET /api/v2/game-point/game-client/{roundId}

Authentication

Requires a user JWT and the game client key header:

Authorization: Bearer user-jwt-token-here
x-game-key: your-game-client-key

Description

This endpoint returns the current user's game score for a specific tournament round. The score reflects the user's performance in that particular round.

Path Parameters

ParameterTypeRequiredDescription
roundIdstringYesUnique identifier for the tournament round

Request Example

GET /api/v2/game-point/game-client/round-123

Response

Success Response (200)

{
"score": 1500
}

Error Response (401)

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

Error Response (404)

{
"message": "Round not found",
"status": 404
}

Response Fields

FieldTypeDescription
scorenumberUser's game score for the specified round

Usage Example

const response = await fetch("https://api.intraverse.io/api/v2/game-point/game-client/round-123", {
method: "GET",
headers: {
Authorization: `Bearer ${userJwtToken}`,
"x-game-key": gameClientKey,
},
});

const result = await response.json();

console.log(`User's score for this round: ${result.score}`);

Error Handling

ErrorDescriptionSolution
UnauthorizedInvalid or missing JWT, wrong scope, or missing x-game-keyCheck token, game client key, and headers
Round not foundRound ID doesn't existVerify the round ID

Next Steps