DocumentationAPI v1
Documentation/Players/Head to head

Head to head

A full rivalry.

Free key7 days behind Livelast 30 days Archive and upwhole archive

Parameters

All optional, all in the query string
player_idid
A player, as pl_ followed by six characters.
opponent_idid
The other player, as pl_ followed by six characters.
fromdate
Earliest date to include, YYYY-MM-DD.
todate
Latest date to include, YYYY-MM-DD.

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

What comes back

In data, read from a real response
FieldTypeExample
playerslist2 items
meetingsnumber39
first_meetingdate"2024-01-03"
last_meetingdate"2026-09-06"
matcheslist3 items

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