DocumentationAPI v1
Documentation/Matches/Biggest upsets

Biggest upsets

The biggest upsets on a day or over a range, biggest first, each with the winner's chance before the match and the reasons it was an upset. Without dates, the newest day held.

Analystonly

Parameters

All optional, all in the query string
datedate
One day, YYYY-MM-DD. Leave out date, from and to for the newest day your plan can see.
fromdate
Earliest day of a range, YYYY-MM-DD. A range covers 31 days at most.
todate
Latest day of a range, YYYY-MM-DD.
competition_idid
Only upsets in this competition.
max_chanceint
The most the winner could have been given before the match to count as an upset, in percent: 5 to 45, default 35.
limitint
How many to return, biggest first. Default 20, at most 100.

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

What comes back

Each item in data, read from a real response
FieldTypeExample
matchobject{ match_id, played_on, round, winner, … }
upset_scorenumber0.854
winner_chance_pctnumber14.6
ratings_beforeobject{ winner, loser, gap }
reasonslist3 items

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.
422bad_parameterA parameter is malformed or out of range, named in the message.
429rate_limitedOver your rate or allowance. Retry-After says when.

Related