Retrieve game history via paginated response

Retrieves data about the games managed by the Sinatra service for the past six months. This method returns a paginated API response.

Info

For performance consideration, rounds_ids should be sent

Note

We have rate limit for this endpoint. If you receive a 429 Too Many Requests response, please slow down your requests.

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

Request Method: GET

Request Parameters

Parameter	Where To Place	Data Type	Description
Authorization	header	String required	The client sends HTTP requests with the Authorization header that contains the word `Basic` followed by a space and a base64-encoded string `username:password`. Example: To authorize a user `demo` with password `p@55w0rd`, the client would send: `Authorization: Basic ZGVtbzpwQDU1dzByZA==`
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. Note: This parameter must be set if the parameter `to` is set. Format: YYYY-MM-DD Example: 2020-10-01
page_number	query	Integer optional	The page number to return. Must be a number greater than 0. Note: This parameter specifies the number of transactions per page, not the number of rounds. Default: 1
page_size	query	Integer optional	The number of transactions per page to return. Must be a number greater than 0. Default: 200
round_ids	query	String optional	Filter the list to return only data for the specified rounds. The round IDs must be separated by a comma. If empty, all rounds are returned. Example: 1,2
time_period	query	String optional	The time period for which to retrieve data. This parameter is ignored if parameters `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. If this parameter is specified with no value, the default value is the current date. Note: This parameter must be set if parameter `from` is set. Format: YYYY-MM-DD Example: 2020-10-01
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

Response Parameters:

None.

Example Response:

Success response:

{
  "page_num": 1,
  "size_per_page": 10,
  "total_count": 393,
  "responses": [
    {
      "round_id": "6228772",
      "brand_id": 2544,
      "brand_name": "dudebet",
      "player_id": "131918",
      "game_id": "130300045",
      "bet": 0.05,
      "win": 0.02,
      "currency": "USD",
      "game_status": "completed",
      "transactions": {
        "good_transactions": [
          {
            "type": "wager",
            "description": "Simple",
            "frb": 0,
            "amount": 0.05,
            "currency": "USD",
            "platform": "desktop",
            "timestamp": "2023-07-25 14:44:13",
            "round_id": "6228772",
            "trans_id": "9079730_int",
            "player_id": "131918",
            "brand_id": 2544,
            "operator_id": 1680,
            "organization_id": 5310,
            "brand_name": "dudebet",
            "operator_name": "Perfect Fusion (Gsoft)",
            "organization_name": "Betinspire",
            "provider_id": 109,
            "provider_name": "Bgaming",
            "casino_session_id": "8cc760a80eb9428c9d75086743d8669e",
            "game_id": "130300045",
            "game_name": "Slotomon Go",
            "game_category": "Slots",
            "game_type": "STANDARD",
            "is_test_account": 0,
            "real_money": 0,
            "bet_amount": 0.05,
            "real_bet_amount": 0,
            "win_amount": 0,
            "real_win_amount": 0
          },
          {
            "type": "result",
            "description": "Simple",
            "frb": 0,
            "amount": 0.02,
            "currency": "USD",
            "platform": "desktop",
            "timestamp": "2023-07-25 14:44:13",
            "round_id": "6228772",
            "trans_id": "9079731_int",
            "player_id": "131918",
            "brand_id": 2544,
            "operator_id": 1680,
            "organization_id": 5310,
            "brand_name": "dudebet",
            "operator_name": "Perfect Fusion (Gsoft)",
            "organization_name": "Betinspire",
            "provider_id": 109,
            "provider_name": "Bgaming",
            "casino_session_id": "8cc760a80eb9428c9d75086743d8669e",
            "game_id": "130300045",
            "game_name": "Slotomon Go",
            "game_category": "Slots",
            "game_type": "STANDARD",
            "is_test_account": 0,
            "real_money": 0,
            "bet_amount": 0,
            "real_bet_amount": 0,
            "win_amount": 0.02,
            "real_win_amount": 0
          }
        ],
        "bad_transactions": []
      }
    },
    {
      "round_id": "400000001671150",
      "brand_id": 2544,
      "brand_name": "dudebet",
      "player_id": "131918",
      "game_id": "135000046",
      "bet": 0.3,
      "win": 0,
      "currency": "USD",
      "game_status": "completed",
      "transactions": {
        "good_transactions": [
          {
            "type": "wager",
            "description": "Simple",
            "frb": 0,
            "amount": 0.3,
            "currency": "USD",
            "platform": "desktop",
            "timestamp": "2023-07-25 14:38:44",
            "round_id": "400000001671150",
            "trans_id": "8096704",
            "player_id": "131918",
            "brand_id": 2544,
            "operator_id": 1680,
            "organization_id": 5310,
            "brand_name": "dudebet",
            "operator_name": "Perfect Fusion (Gsoft)",
            "organization_name": "Betinspire",
            "provider_id": 1167,
            "provider_name": "Rival",
            "casino_session_id": "033756ad27754cddbdb1fa99f3fcfb62",
            "game_id": "135000046",
            "game_name": "Daikoku Blessings",
            "game_category": "Slots",
            "game_type": "STANDARD",
            "is_test_account": 0,
            "real_money": 0.3,
            "bet_amount": 0.3,
            "real_bet_amount": 0.3,
            "win_amount": 0,
            "real_win_amount": 0
          },
          {
            "type": "result",
            "description": "Simple",
            "frb": 0,
            "amount": 0,
            "currency": "USD",
            "platform": "desktop",
            "timestamp": "2023-07-25 14:38:44",
            "round_id": "400000001671150",
            "trans_id": "8096704",
            "player_id": "131918",
            "brand_id": 2544,
            "operator_id": 1680,
            "organization_id": 5310,
            "brand_name": "dudebet",
            "operator_name": "Perfect Fusion (Gsoft)",
            "organization_name": "Betinspire",
            "provider_id": 1167,
            "provider_name": "Rival",
            "casino_session_id": "033756ad27754cddbdb1fa99f3fcfb62",
            "game_id": "135000046",
            "game_name": "Daikoku Blessings",
            "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
          }
        ],
        "bad_transactions": []
      }
    }
  ]
}

Error Response:

{
  "errMsg": "bad request"
}

Response codes:

Code	Status	Message
200	success	Got API games history successfully
400	Bad Request	Bad Request
401	Authentication information is missing or invalid	unauthorized
403	forbidden	operation forbidden
422	Invalid parameters	Invalid parameters
429	Too Many Requests	slow down
500	internal server error	internal server error