DocumentationAPI v1
Documentation/Players/Player form

Player form

Recent form measured against expectation.

Livelast 30 days Archive and upwhole archive

Parameters

The path first, then the query
player_ididrequired
A player, as pl_ followed by six characters.
matchesint
How many recent matches to measure form over: 5 to 100, default 20.

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}/form
Run it to see your limits

What comes back

In data, read from a real response
FieldTypeExample
player_idid"pl_VEB8HM"
overstring"20 matches"
wonnumber17
lostnumber3
win_pctnumber85
legsobject{ for, against, difference }
three_dart_avgnumber100.07
runstring"LWWWWWWWLWWWWWWWLWWW"
fromdate"2026-07-26"
todate"2026-09-20"

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