Rates
/v1/rates
What you are charged: your revenue share per provider, per band of your monthly turnover, in the market you are billed under.
It is the same resolution the invoice runs, so the percent you read here is the percent the invoice will carry. Read it on a schedule; it changes when your agreement does.
{
"revenue_base": "ngr", // "ggr" or "ngr": what the percentages are a share of
"market": "rest_of_world", // the column you are billed in: "rest_of_world" or "asia"
"regulated": false,
"tier_mode": "whole", // "progressive": each band prices only the turnover inside it
"providers": [
{
"provider_code": "pragmaticplay",
"provider_name": "Pragmatic Play",
"tiers": [ // your monthly turnover ladder; empty when priced flat
{ "currency": "USD", "ordinal": 1, "from_amount": 0, "to_amount": 100000 },
{ "currency": "USD", "ordinal": 2, "from_amount": 100000, "to_amount": null }
],
"rates": [ // the billed market only
{ "tier_ordinal": 1, "percent": 12.5 },
{ "tier_ordinal": 2, "percent": 11 }
],
"rates_by_market": [
{ "market": "rest_of_world", "tier_ordinal": 1, "percent": 12.5 },
{ "market": "asia", "tier_ordinal": 1, "percent": 9 }
],
"sections": [ // games of the provider priced apart
{ "section_code": "live", "rates": [ { "tier_ordinal": 1, "percent": 12 } ] }
]
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
| revenue_base | string | ggr or ngr: what the percentages are a share of. |
| market | string | The column you are billed in: rest_of_world or asia. |
| regulated | boolean | Whether you are billed as a regulated market. |
| tier_mode | string | whole prices the month at the band it lands in; progressive prices each band's slice at that band's percent. |
| providers[].tiers | object[] | Your monthly turnover ladder. A flat deal has one band, tier_ordinal 1. A second currency is a second ladder, read against turnover in that currency, not a conversion. |
| providers[].rates | object[] | The billed market alone: tier_ordinal and percent, a JSON number where 12.5 means 12.5%, not 0.125. |
| providers[].rates_by_market | object[] | The whole grid, one entry per market and band. |
| providers[].sections | object[] | Games priced apart (live, blackjack); a game in no listed section is at rates. |
/v1/invoices/estimate
What your invoice would say if it were drawn now, at these rates.
Without parameters it covers the first of the month through today; with from and to (both, YYYY-MM-DD, to included, at most 366 days) the period you name. Nothing is saved: the invoice itself still arrives by the invoice webhook, and its lines read exactly as these.
{
"period_from": "2026-11-01T00:00:00Z",
"period_to": "2026-11-08T00:00:00Z", // exclusive: the midnight after the last day
"as_of": "2026-11-07T10:49:13Z",
"revenue_base": "ngr",
"lines": [{ // one per currency; nothing is converted
"currency": "EUR",
"revenue": 1250.00, "bonus": 0, "gross": 1250.00,
"rate_percent": 12.5, "amount": 156.25, "tax_percent": 0, "tax_amount": 0, "total": 156.25,
"brands": [
{ "provider_code": "pragmaticplay", "section_code": null, "ggr": 1250.00, "bonus": 0, "revenue": 1250.00, "gross": 1250.00,
"rate_percent": 12.5, "amount": 156.25,
"band": { "ordinal": 1, "from_amount": 0, "to_amount": 100000, "basis_amount": 1250.00, "currency": "EUR" } }
]
}]
}rate_percent on a line is null where its brands were priced apart. band is the band of your turnover ladder the rate was read at, with basis_amount, the turnover that put the month there. An incomplete or reversed period answers 422 VALIDATION_FAILED.
