Tournaments

GET/api/v1/tournaments

List all tournaments

This endpoint allows you to retrieve a paginated list of all your tournaments. By default, 30 tournaments are shown per page (max 100 via page[size]).

Sorting is ascending by default and can be reversed by adding a hyphen (-) to the start of the property name.

Optional attributes

Name
page[number]
Type
integer
Description
The page number
Name
page[size]
Type
integer
Description
Number of results per page (max 100)
Name
filter[year]
Type
integer
Description
Filter the tournaments by year.
Name
filter[active_on]
Type
date
Description
Filter to tournaments active on a given date. Returns tournaments where start_date ≤ date and (expiration_date ≥ date or expiration_date is null). Use for multi-day events.
Name
filter[starts_before]
Type
date
Description
Filter the tournaments by starts before certain date. (YYYY-MM-DD)
Name
filter[starts_after]
Type
date
Description
Filter the tournaments by starts after certain date. (YYYY-MM-DD)
Name
sort
Type
string
Description
Sort by start_date, dctv_title

Request

GET

/api/v1/tournaments

curl -G https://public-api.dartconnect.com/api/v1/tournaments \
-H "Authorization: Bearer {token}" \
-d "page[number]=1" \
-d "page[size]=100" \
-d "filter[active_on]=2026-03-07" \
-d "filter[year]=2026" \
-d "sort=-start_date"

Response

{
    "data": [
        {
            "id": "dutchopen24",
            "start_date": "2024-02-01T00:00:00.000000Z",
            "expiration_date": "2024-02-04T00:00:00.000000Z",
            "closed": "Y",
            "dctv_title": "TOTO Dutch Open Darts 2024",
            "country_code": "NL",
            "city": "Assen",
        },
        {
            "id": "dutchopen25"
            // ...
        }
    ]
}

GET/api/v1/tournaments/:tournament_id

Retrieve a tournament

This endpoint allows you to retrieve a tournament by providing the DartConnect Tournament ID.

Request

GET

/api/v1/tournaments/dutchopen24

curl https://public-api.dartconnect.com/api/v1/tournaments/dutchopen24 \
-H "Authorization: Bearer {token}"

Response

{
    "data": {
        "id": "dutchopen24",
        "start_date": "2024-02-01T00:00:00.000000Z",
        "expiration_date": "2024-02-04T00:00:00.000000Z",
        "closed": "Y",
        "dctv_title": "TOTO Dutch Open Darts 2024",
        "country_code": "NL",
        "city": "Assen"
    }
}