DocumentationAPI v1
Documentation/Players/Player matches

Player matches

Match log with the market and rating beside every result.

Livelast 30 days Archive and upwhole archive Cursor paging

Parameters

The path first, then the query
player_ididrequired
A player, as pl_ followed by six characters.
fromdate
Earliest date to include, YYYY-MM-DD.
todate
Latest date to include, YYYY-MM-DD.
competition_idid
Only matches in this competition.
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/players/{id}/matches
Run it to see your limits

What comes back

Each item in data, read from a real response
FieldTypeExample
match_idid"mt_0CWS66BSK1H725020W3E"
played_ondate"2026-09-20"
roundstring"quarter_final"
winnerobject{ player_id, name, score }
loserobject{ player_id, name, score }
eventobject{ event_id, competition_id, name, date, … }
resultstring"lost"
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.
402upgrade_requiredYour plan does not reach this endpoint. The message names the plan that does.
400bad_idAn id of the wrong type in the path.
404not_foundNo record with that id.
422bad_parameterA parameter is malformed or out of range, named in the message.
429rate_limitedOver your rate or allowance. Retry-After says when.

Related