Skip to Content
Reporting APIGGR Summary

GGR Summary

Bets, wins and GGR of your casino for a period, to reconcile with your own books. Figures are per currency, in the currency the bets were booked in — no exchange rate is applied.

  • GGR = bet − win.
  • Cancelled (rolled back) transactions are left out.
  • The figures are the same as in the GGR report of the admin panel.

Request

[POST] {PROVIDER_URL}/v2/ggr-summary

The parameters are sent as a JSON object body. Any other method is answered with HTTP 405.

ParameterTypeRequiredDescription
casino_idintegeryesyour CASINO_ID
start_datestringyesfirst day of the period, Y-m-d
end_datestringyeslast day of the period, Y-m-d, inclusive. The period can be at most 93 days
timezonestringnowhose days the period means, see Time zones. Defaults to Europe/Budapest
groupstringnohow rows are broken down: day (default), provider, game or player

Request body:

{ "casino_id": 1000, "start_date": "2026-09-01", "end_date": "2026-09-14", "timezone": "UTC", "group": "day" }

Response

Successful response will be returned as a json object.

{ "casino_id": 1000, "start_date": "2026-09-01", "end_date": "2026-09-14", "timezone": "UTC", "period_utc": ["2026-09-01 00:00:00", "2026-09-15 00:00:00"], "group": "day", "totals": [ {"currency": "GBP", "num_of_bets": 680539, "bet": 1125803.37, "win": 1079844.86, "ggr": 45958.51} ], "rows": [ {"currency": "GBP", "day": "2026-09-01", "num_of_bets": 51234, "bet": 80211.4, "win": 77001.2, "ggr": 3210.2}, ... ] }
ParameterTypeDescription
casino_idintegerthe casino asked for
start_date, end_datestringthe period asked for
timezonestringthe time zone the days are counted in
period_utcarray | null[from, to) in UTC, the interval actually read, when a timezone was given. null for the default time zone
groupstringthe breakdown of rows
totalsarrayone entry per currency for the whole period
rowsarraythe breakdown, one entry per currency and group value

Totals and rows

FieldTypeDescription
currencystringISO 4217 code. unknown for transactions with no currency recorded
num_of_betsintegernumber of bets
betfloattotal stakes
winfloattotal wins
ggrfloatbet − win, negative when the players won more than they staked

rows carries the field of the chosen group as well:

groupFieldsOrder
dayday (Y-m-d)by day
providerprovider (game studio)by GGR, highest first
gamegame, providerby GGR, highest first
playerplayer_id (your player id)by GGR, highest first

Time zones

Without timezone, a day is the aggregator’s day, Europe/Budapest. To match your own books, ask for your time zone instead. Accepted values:

UTC, Europe/London, Europe/Budapest, Europe/Athens, Asia/Dubai, Asia/Shanghai, Asia/Tokyo, America/New_York, America/Los_Angeles

A time zone other than the default is computed from hourly data, which exists from 2026-10-11. A period starting earlier is answered with HTTP 400 — leave timezone out for older periods.

Errors

HTTP 400 with the reason in message: missing or invalid parameter, a period longer than 93 days, a time zone not available for the period, or a body that is not a JSON object. See Errors for the other statuses.

Last updated on