/
v3.0.11Get access

getClientFreeBetBalanceHistory

Returns the french free bet balance history for the current client. It lists transactions that changed the free bet balance, including amount, balance after each change, timestamp, document type (e.g. Bet), and related product/game data. It is used to show free bet activity in account and history views and to explain how the free bet balance changed over time.

Request parameters:

Name
DescriptionTypeValuesDefault
from
Unix timestamp indicating the start date of the period for which free bet bonus balance history should be retrieved.string--
to
Unix timestamp indicating the end date of the period for which free bet bonus balance history should be retrieved.string--
product
Product type for which the bonus history is requested; possible values are "Sport" or "Casino", but for french free bet bonus the product is "Sport".string"Sport", "Casino"-
operationType
Optional filter specifying the bet typestring"none", "chain", "heinz", "single", "trixie", "system", "yankee", "patient", "goliath", "multiple", "lucky_31", "lucky_15", "lucky_63", "betBuilder", "superHeinz", "superYankee"-

Call example:

getClientFreeBetBalanceHistory({
  product: 'Casino',
  from: 1715731200,
  to: 1718319600,
  operationType: 'single'
})

Response examples:

{
  code: 0,
  rid: '0',
  data: {
    result: 0,
    result_text: null,
    details: [{
      Amount: -1,
      DocumentId: 184413593970,
      TransactionId: 256513928784,
      DocumentTypeId: 0,
      DocumentTypeName: 'Bet',
      Balance: 7.42,
      Created: 1766740272,
      Game: 'SportsBook',
      GameId: -1,
      PaymentSystemId: null,
      PaymentSystemName: null,
      ProductCategoryId: 1,
      Product: 'Betting',
      ProductId: 8,
      BuddyId: null,
      BuddyLogin: null,
      ThirdPartyId: null,
      HasChildren: null
    }]
  }
}

Response parameters:

NameDescriptionTypeValues
Amount
Transaction amountnumber-
DocumentId
Document identifiernumber-
TransactionId
Transaction identifiernumber-
DocumentTypeId
Document type identifiernumber-
DocumentTypeName
Document type namestring-
Balance
Balance after transactionnumber-
Created
Transaction date (Unix timestamp)number"Unix" "timestamp"
Game
Game provider / system namestring"e.g." "SportsBook"
GameId
Game identifierstring-
PaymentSystemId
Payment system identifiernumber-
PaymentSystemName
Payment system namestring-
ProductCategoryId
Product category identifiernumber-
Product
Product namestring-
ProductId
Product identifiernumber-
BuddyId
Related buddy identifiernumber-
BuddyLogin
Related buddy loginstring-
ThirdPartyId
Third-party identifierstring-
HasChildren
Has child transactions flagbooleantrue / false