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-summaryThe parameters are sent as a JSON object body. Any other method is answered with
HTTP 405.
| Parameter | Type | Required | Description |
|---|---|---|---|
| casino_id | integer | yes | your CASINO_ID |
| start_date | string | yes | first day of the period, Y-m-d |
| end_date | string | yes | last day of the period, Y-m-d, inclusive. The period can be at most 93 days |
| timezone | string | no | whose days the period means, see Time zones. Defaults to Europe/Budapest |
| group | string | no | how 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},
...
]
}| Parameter | Type | Description |
|---|---|---|
| casino_id | integer | the casino asked for |
| start_date, end_date | string | the period asked for |
| timezone | string | the time zone the days are counted in |
| period_utc | array | null | [from, to) in UTC, the interval actually read, when a timezone was given. null for the default time zone |
| group | string | the breakdown of rows |
| totals | array | one entry per currency for the whole period |
| rows | array | the breakdown, one entry per currency and group value |
Totals and rows
| Field | Type | Description |
|---|---|---|
| currency | string | ISO 4217 code. unknown for transactions with no currency recorded |
| num_of_bets | integer | number of bets |
| bet | float | total stakes |
| win | float | total wins |
| ggr | float | bet − win, negative when the players won more than they staked |
rows carries the field of the chosen group as well:
| group | Fields | Order |
|---|---|---|
| day | day (Y-m-d) | by day |
| provider | provider (game studio) | by GGR, highest first |
| game | game, provider | by GGR, highest first |
| player | player_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.