Skip to main content
GET
/
v2
/
regions
List Regions
curl --request GET \
  --url https://api.mrdoge.co/v2/regions \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 1,
      "caption": "England",
      "_count": {
        "competitions": 5,
        "events": 120
      },
      "availableSports": [
        "soccer",
        "tennis"
      ],
      "competitions": [
        {
          "id": 1,
          "caption": "Premier League",
          "regionId": 1,
          "region": "<unknown>",
          "_count": {
            "events": 38
          }
        }
      ]
    }
  ]
}
Public Endpoint: No API key required
This endpoint returns all regions where Mr. Doge has sports coverage, including:
  • Localized region names (supports en, es, pt)
  • Number of competitions per region
  • Number of events (filtered by query parameters)
  • Available sports in each region
  • List of competitions with sport references
Perfect for building region selectors or filtering events by location.

​
Query Parameters

​
locale
string
default:"en"
Language code for localized region names. Supported: en, es, pt
​
date
string
Filter regions with events on specific date (YYYY-MM-DD format)Example: 2025-11-08
Cannot be used together with startDate or endDate. Choose either date for single-day filtering or startDate/endDate for range filtering.
​
startDate
string
Filter regions with events starting from this date
Cannot be used together with date parameter.
​
endDate
string
Filter regions with events ending on this date
Cannot be used together with date parameter.
​
status
string
default:"upcoming,live"
Filter by event status (repeat or comma-separate values). Use status=completed to inspect historical dates.
​
timezone
string
Timezone for date filteringExample: America/New_York, Europe/London

​
Response

Returns an object with a data array containing region objects.
​
data
array

​
Example Request

curl https://api.mrdoge.co/v2/regions?locale=en&date=2025-11-08

​
Example Response

{
  "data": [
    {
      "id": 1,
      "caption": "World",
      "_count": {
        "competitions": 1,
        "events": 10
      },
      "availableSports": [
        {
          "id": 1,
          "name": "soccer"
        },
      ],
      "competitions": [
        {
          "id": 39,
          "caption": "World Cup",
          "sportId": 1
        },
      ]
    }
  ]
}

​
Use Cases

Region Selector

Build a dropdown to let users filter events by country

Coverage Map

Display which regions have the most events and competitions

Localization

Show region names in user’s preferred language

Sport Filtering

Show which regions have specific sports available

Authorizations

​
Authorization
string
header
required

Use your API key from the Mr. Doge dashboard. Format: Bearer sk_live_... or Bearer sk_test_...

Query Parameters

​
locale
string
default:en

Language code for localized region names

Example:

"en"

​
date
string<date>

Filter regions with events on specific date (YYYY-MM-DD)

Example:

"2025-11-08"

​
startDate
string<date>

Filter regions with events starting from this date

​
endDate
string<date>

Filter regions with events ending on this date

​
status
enum<string>[]

Filter regions by event status (repeat or comma-separate values). Defaults to upcoming and live events.

Available options:
upcoming,
live,
completed
​
timezone
string

Timezone for date filtering

Example:

"America/New_York"

Response

200 - application/json

List of regions

​
data
object[]