Regions

Regions Endpoint Documentation

Use the Regions endpoint to retrieve a comprehensive, hierarchical list of all available betting areas. This endpoint maps the relationships between global regions, specific countries, and their respective sports leagues, making it the primary tool for building navigation menus or league filters in your application.

To see how these regions are structured, check out the Regions API Reference.

Query Parameters

Parameter	Type	Default	Description
status	enum	upcoming	Filter leagues by activity. Use upcoming for active/near-future events or all for the full database.
language	enum	en	Returns localized names. Supported: en (English), es (Spanish), bg (Bulgarian).

Response Schema

The response returns an array of objects, where each entry represents a unique "League Pathway" (Region > Country > League).

Field Definitions

Field	Type	Description
region	object	The broad geographical area (e.g., Europe, Asia, International).
country	object	The specific nation, including the ISO alpha3 code.
league	object	The competition details, including the technical level.
sport	object	The type of sport (e.g., Football).
count	integer	Total number of available fixtures for this league.
live	integer	Number of fixtures currently in-play.
popular	boolean	Flag for high-traffic leagues (e.g., Premier League, Bundesliga).
level	integer	The tier of the league (1 = Top Flight, 5+ = Amateur/Regional).

Example JSON Response

{
  "region": {
    "id": 2,
    "name": "EUROPE - Main"
  },
  "country": {
    "id": 4,
    "name": "Germany",
    "alpha3": "DEU"
  },
  "league": {
    "id": 1310,
    "name": "Reg. Cup Rheinland",
    "level": 5
  },
  "sport": {
    "id": 1,
    "name": "Football"
  },
  "count": 12,
  "live": 1,
  "popular": false,
  "level": 5
}

Integration Tip

Use the level and popular fields to prioritize data display. Most users prefer to see Popular leagues or Level 1 competitions at the top of their search results.