Game History API

The Game History API provides an endpoint for retrieving a replay URL for a specific game round. All requests are passed from the operator to VeliGames using the HTTP POST method with the content type application/json. The signature parameter in the header is mandatory.

See also

Authentication

API Method: replay-game

The operator makes a request to the replay-game endpoint to obtain a URL for replaying a specific game round. The returned URL can be opened directly in a browser to view a visual replay of the round.

Note

Not all providers have a native replay implementation. For supported providers (pragmatic, pragmaticlive, onlyplay, etc), the returned URL links to the provider’s own replay page. For the VeliSports provider, the URL links to a round summary generated by VeliGames from internal gaming activity, including stake information. For all other providers without native support, VeliGames generates a round summary from internal gaming activity data.

Internal data is displayed only in English.

Path:

https://VELIGAMES_API_URL/game-history/public/replay-game

HTTP Method:

POST

Request body

The following parameters are mandatory unless stated otherwise.

Parameter	Type	Description
brandId	string	The identifier of the casino brand (also known as Agent).
gameId	string	The identifier of the game.
language	string(2)	A language code for the preferred display language (e.g. en, fr).
playerId	string	The player’s unique identifier.
providerId	string	The identifier of the game provider.
roundId	string	The identifier of the game round to replay.
currency	string	The player’s currency code (ISO 4217, e.g. EUR, USD).

An example of the replay-game API method

curl --request POST \
'https://VELIGAMES_API_URL/game-history/public/replay-game' \
--header 'signature: OPERATOR_ID:vVh+FCw....3M5EsKxeSS6+gA==' \
--header 'Content-Type: application/json' \
--data '{
    "brandId": "someBrand",
    "gameId": "1000",
    "language": "en",
    "playerId": "player123",
    "providerId": "velisports",
    "roundId": "actualRound"
}'

JSON Response

Parameter	Type	Description
url	string	A URL to the game round replay. Open this URL in a browser to view the replay. If no round data is found, a default not-found page URL is returned.

Successful response

{
    "url": "https://replay-url"
}

Error Codes

Error ID	Status Code	Description
UNKNOWN_ERROR	500	A generic error or an internal server error that can be retried
BAD_REQUEST	400	Missing or invalid parameters.
UNAUTHORIZED	401	Invalid signature or missing access to the requested resource.

See also

Authentication