Skip to main content
GET
/
v2
/
competitions
List Competitions
curl --request GET \
  --url https://api.mrdoge.co/v2/competitions \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 1,
      "caption": "Premier League",
      "regionId": 1,
      "region": {
        "id": 1,
        "caption": "England",
        "_count": {
          "competitions": 5,
          "events": 120
        },
        "availableSports": [
          "soccer",
          "tennis"
        ],
        "competitions": "<array>"
      },
      "_count": {
        "events": 38
      }
    }
  ]
}
Public Endpoint: No API key required
Returns all competitions (leagues, tournaments, cups) across all sports. Each competition includes event counts and parent region information. Use this endpoint to:
  • Build competition selectors
  • Display leagues with upcoming matches
  • Filter events by competition
  • Show popular leagues

Query Parameters

locale
string
default:"en"
Language for competition and region names. Supported: en, es, pt
regionId
string
Filter competitions by region IDExample: 6 for England
date
string
Filter competitions with events on specific date (YYYY-MM-DD)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 competitions with events starting from this date
Cannot be used together with date parameter.
endDate
string
Filter competitions with events ending on this date
Cannot be used together with date parameter.
status
string
default:"upcoming,live"
Filter by event status. Pass multiple values with commas or repeat the parameter (e.g., status=completed). Defaults to upcoming + live events.
timezone
string
Timezone for date filteringExample: America/New_York

Response

data
array

Example Request

curl "https://api.mrdoge.co/v2/competitions?regionId=6&date=2025-11-15&locale=en"

Example Response

{
  "data": [
    {
      "id": 847,
      "caption": "Premier League",
      "regionId": 6,
      "region": {
        "id": 6,
        "caption": "England"
      },
      "_count": {
        "events": 4
      }
    },
    {
      "id": 29,
      "caption": "LaLiga",
      "regionId": 5,
      "region": {
        "id": 5,
        "caption": "Spain"
      },
      "_count": {
        "events": 4
      }
    }
  ]
}

Use Cases

Competition Selector

Build dropdowns to let users filter events by league or tournament

League Overview

Show all competitions in a specific region with upcoming match counts

Multi-Sport Coverage

Display which competitions are active across different sports

Schedule Widgets

Create widgets showing leagues with the most events on specific dates
Competition data is optimized for fast responses. Combine with the Events endpoint to build complete league schedules.

Authorizations

Authorization
string
header
required

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

Query Parameters

regionId
string

Filter by region ID

Example:

"1"

date
string<date>

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

Example:

"2025-11-08"

startDate
string<date>

Filter competitions with events starting from this date

endDate
string<date>

Filter competitions with events ending on this date

status
enum<string>[]

Filter competitions 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 competitions

data
object[]