DocumentationAPI v1
Documentation/Reference and coverage/Competitions

Competitions

Every competition with its tier and format.

Free key7 days behind Livelast 30 days Archive and upwhole archive Cursor paging

Parameters

All optional, all in the query string
organiserstring
Only this tour body, as /v1/organisers names it: pdc, pdc_development, pdc_affiliate, bdo or unattributed.
tierenum
Only this tier: majors, players_championship, european_tour, world_series, qualifiers, development_tour, challenge_tour, womens_series, junior, regional, wdf_platinum, wdf_gold, wdf_silver, wdf_bronze, and so on.
qstring
Search text. Accents and particles are folded, so "van gerwen" finds Michael van Gerwen.
limitint
How many to return. Default 50, at most 200.
cursorcursor
Carry on from here: pass back meta.next_cursor exactly as it came.

Try it

Your key, sent from your browser straight to the API
Paste your keyGet a free one in a minute
GET
https://api.dartsapi.com/v1/competitions
Run it to see your limits

What comes back

Each item in data, read from a real response
FieldTypeExample
competition_idid"cp_X63B14"
namestring"25 Bull Darts UK Open Qualifier"
organisernullnull
tierstring"qualifiers"
editionsnumber9
first_eventdate"2024-12-14"
last_eventdate"2025-02-15"
meta.next_cursorstringPass back as cursor for the next page; null on the last

When it refuses

Every error code
StatusCodeWhen
401no_keyNo key, a malformed key, or one that is not ours.
422bad_parameterA parameter is malformed or out of range, named in the message.
429rate_limitedOver your rate or allowance. Retry-After says when.

Related