Retrieve game history

Retrieve game history

Retrieves data about the games managed by the Sinatra service for the past six months.

Request endpoint: /transactions/{version}/games/history

Request Method: GET

Request Parameters

Parameter Where To Place Data Type Description
brand_ids query String optional Filter the list to return only data for the specified brands. The brand IDs must be separated by a comma.
The specified IDs must exist in the system.
Default: all
Example: 1,2
from query String optional The start date from which to get game data.
The result contains all games that were added or updated after the specified date.
If this parameter is specified with no value, the default value is the current date.
Format: YYYY-MM-DD
Example: 2020-10-01
game_category query String optional Filter the list to return only data for the specified game categories. The game categories must be separated by a comma.
The specified game category must exist in the system.
Default: all
game_id query String optional Return the game with the specified game ID. Only digits may be specified.
Example: 999999
game_type query String optional Filter the list to return only data for the specified game types. The game types must be separated by a comma.
The specified game types must exist in the system.
Default: all
jwt-auth header String required The session ID received from the login request. The session ID is valid for only 20 minutes.
operator_id query Integer optional Filter the list to return only data for the specified operators. The operator IDs must be separated by a comma.
The specified IDs must exist in the system.
Default: all
Example: 1,2
organization_ids query String optional Filter the list to return only data for the specified organizations. The organization IDs must be separated by a comma.
The specified IDs must exist in the system.
Default: all
Example: 1,2
player_id query String optional Return data for the specified player.
Example: 1
provider_ids query String optional Filter the list to return only data for the specified game providers. The game provider IDs must be separated by a comma.
Default: all
Example: 1,2
round_id query String optional Return data for the specified round.
Example: 1
session_id query String optional Return data for the specified session.
Example: 1
test_accounts query String optional Filter the list to include data for test accounts.
Valid values:
false - Exclude test accounts.
true - Include test accounts.
Default: false
time_period query String optional The time period for which to retrieve data. Ignored if from and to are specified.
Valid values: today, yesterday, last 7 days, last 30 days.
Default: today
to query String optional The end date until which to get game data. The result contains all games that were added or updated before the specified date.
Format: YYYY-MM-DD
Example: 2020-10-01
transaction_id query String optional Return data for the specified transaction.
Example: 1
version path String required The API version. Only version 1.0 is currently supported. Other version values are accepted but are treated as 1.0.
Example: 1.0

Example Response:

Success response:

[
  {
    "round_id": "1612746001757001",
    "first_transaction": "2021-02-08 01:00:02",
    "last_transaction": "2021-02-08 01:00:02",
    "brand_id": 1,
    "brand_name": "Test Brand",
    "player_id": "44065272",
    "game_id": "9999999",
    "game_name": "Test Game",
    "provider_id": 1,
    "provider_name": "Test Provider",
    "bet": 1,
    "win": 0.2,
    "real_bet": 1,
    "real_win": 0.2,
    "currency": "EUR",
    "platform": "mobile",
    "transactions": {
      "good_transactions": [
        {
          "type": "wager",
          "description": "Simple",
          "frb": 0,
          "amount": 1,
          "currency": "EUR",
          "platform": "mobile",
          "timestamp": "2021-02-08 01:00:02",
          "round_id": "1612746001757001",
          "trans_id": "19badfbfcdbf474eac26a90fd7ba9b51",
          "player_id": "44065272",
          "brand_id": 1,
          "operator_id": 1,
          "organization_id": 1,
          "brand_name": "Test Brand",
          "operator_name": "Test Operator",
          "organization_name": "Test Organization",
          "provider_id": 1,
          "provider_name": "Test Provider",
          "casino_session_id": "44_69501d2f-dfba-4824-b912-fbaced24eea5",
          "game_id": "9999999",
          "game_name": "Test Game",
          "game_category": "Slots",
          "game_type": "STANDARD",
          "is_test_account": 0,
          "real_money": 1,
          "bet_amount": 1,
          "real_bet_amount": 1,
          "win_amount": 0,
          "real_win_amount": 0
        },
        {
          "type": "result",
          "description": "Simple",
          "frb": 0,
          "amount": 0.2,
          "currency": "EUR",
          "platform": "mobile",
          "timestamp": "2021-02-08 01:00:02",
          "round_id": "1612746001757001",
          "trans_id": "19badfbfcdbf474eac26a90fd7ba9b51",
          "player_id": "44065272",
          "brand_id": 1,
          "operator_id": 1,
          "organization_id": 1,
          "brand_name": "Test Brand",
          "operator_name": "Test Operator",
          "organization_name": "Test Organization",
          "provider_id": 1,
          "provider_name": "Test Provider",
          "casino_session_id": "44_69501d2f-dfba-4824-b912-fbaced24eea5",
          "game_id": "9999999",
          "game_name": "Test Game",
          "game_category": "Slots",
          "game_type": "STANDARD",
          "is_test_account": 0,
          "real_money": 0.2,
          "bet_amount": 0,
          "real_bet_amount": 0,
          "win_amount": 0.2,
          "real_win_amount": 0.2
        }
      ],
      "bad_transactions": [
        {
          "type": "wager",
          "description": "Simple",
          "frb": 0,
          "amount": 1,
          "currency": "EUR",
          "platform": "mobile",
          "timestamp": "2021-02-08 01:00:02",
          "round_id": "1612746001757001",
          "trans_id": "19badfbfcdbf474eac26a90fd7ba9b51",
          "player_id": "44065272",
          "brand_id": 1,
          "operator_id": 1,
          "organization_id": 1,
          "brand_name": "Test Brand",
          "operator_name": "Test Operator",
          "organization_name": "Test Organization",
          "provider_id": 1,
          "provider_name": "Test Provider",
          "casino_session_id": "44_69501d2f-dfba-4824-b912-fbaced24eea5",
          "game_id": "9999999",
          "game_name": "Test Game",
          "game_category": "Slots",
          "game_type": "STANDARD",
          "is_test_account": 0,
          "real_money": 0,
          "bet_amount": 0,
          "real_bet_amount": 0,
          "win_amount": 0,
          "real_win_amount": 0,
          "http_status": "200",
          "raw_request": "raw request...",
          "raw_response": "raw response.."
        }
      ]
    }
  }
]

Error Response:

{
  "errMsg": "bad request"
}

Response codes:

Code Status Message
200 success Got games history successfully
400 Bad Request Bad Request
401 unauthorized unauthorized
403 forbidden operation forbidden operation
500 internal server error internal server error