Tournaments

GET/api/v1/tournaments

List all tournaments

This endpoint allows you to retrieve a paginated list of all your tournaments. By default, a maximum of ten tournaments are shown per page.

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

Optional attributes

Name
page
Type
integer
Description
The page number
Name
filter[year]
Type
integer
Description
Filter the tournaments by year.
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=1
-d filter[year]=2024
-d sort=-date_of_birth

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"
    }
}