Skip to content
Catalogue / Rates
Catalogue

Rates

GET

/v1/rates

What you are charged: your revenue share per provider, per band of your monthly turnover, in the market you are billed under.

SignedSandboxProduction

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.

Response 200
{
  "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

FieldTypeDescription
revenue_basestringggr or ngr: what the percentages are a share of.
marketstringThe column you are billed in: rest_of_world or asia.
regulatedbooleanWhether you are billed as a regulated market.
tier_modestringwhole prices the month at the band it lands in; progressive prices each band's slice at that band's percent.
providers[].tiersobject[]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[].ratesobject[]The billed market alone: tier_ordinal and percent, a JSON number where 12.5 means 12.5%, not 0.125.
providers[].rates_by_marketobject[]The whole grid, one entry per market and band.
providers[].sectionsobject[]Games priced apart (live, blackjack); a game in no listed section is at rates.
Band amounts and percents are JSON numbers. See Money.
GET

/v1/invoices/estimate

What your invoice would say if it were drawn now, at these rates.

SignedSandboxProduction

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.

Response 200
{
  "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.