Get user leaderboard

Overview

Returns the leaderboard of affiliated onboarded users for a given range and affiliate username.

All amounts are in EUR.

---

Endpoint

GET /affiliate/leaderboard

---

Query Parameters

Summary Table

Parameter	Type	Required	Constraints	Description
from	Date	No	≥ 2020-01-01	Start date for filtering the leaderboard.
limit	Number	Yes	1–100	Maximum number of results to return.
to	Date	No	≥ 2020-01-01	End date for filtering the leaderboard.
username	String	Yes	Your affiliate	Your affiliate username.

Parameters

from (optional)

• Type: Date
• Description: Start date for leaderboard data filtering.
• Constraints: Cannot be earlier than January 1st, 2020.

limit (required)

• Type: number
• Description: Maximum number of leaderboard entries to return.
• Constraints: Minimum 1, maximum 100.

to (optional)

• Type: Date
• Description: End date for leaderboard data filtering.
• Constraints: Cannot be earlier than January 1st, 2020.

username (required)

• Type: string
• Description: The affiliate username your API key was issued for.
• Constraints: Must match your API key. Any other value, or no value, returns 403 Forbidden.

Notes

• If both from and to are omitted, the leaderboard will return results based on all available data.
• Results only include players onboarded by your affiliate account, and still respect the date and limit filters.
• total_wager is in EUR. Wagers placed in other currencies are converted at fixed rates, and amounts are rounded to cents.
• Player usernames are masked.

---

Example request

GET /affiliate/leaderboard?from=2025-09-01T00:00:00.000Z&to=2025-09-30T00:00:00.000Z&username=<AFFILIATE_USERNAME>&limit=2

---

Responses

200 OK

{
  "items": [
    {
      "username": "FO**AR",
      "total_wager": 100
    },
    {
      "username": "BI**AR",
      "total_wager": 90
    }
  ],
  "limit": 2
}

400 Bad request

Bad date

{
    "message": "Validation failed (invalid date format)",
    "error": "Bad Request",
    "statusCode": 400
}

Limit too big

{
    "message": "Validation failed",
    "error": {
        "errors": [],
        "properties": {
            "limit": {
              "errors": ["Too big: expected number to be <=100"]
            }
        }
    },
    "statusCode": 400
}

403 Forbidden

username is missing or is not the affiliate your API key was issued for:

{
    "message": "You are not authorized to access this resource.",
    "error": "Forbidden",
    "statusCode": 403
}

Missing or invalid API key:

{
    "message": "Forbidden resource",
    "error": "Forbidden",
    "statusCode": 403
}

---

Changelog

• v1.1.0 – limit goes up to 100. username is required and must be your own affiliate. total_wager is reported in EUR, rounded to cents.
• v1.0.0 – Initial release of the leaderboard endpoint.