Race Results API
Get public Race Results data as typed JSON: find a race, list a race's events and result by bib. One API key, and a published credit cost for every endpoint.
Race Results endpoints
All endpoints authenticate via x-api-key
Find a race
/v1/races/search
Searches finished races by name on one timing platform. Each hit carries the ids /v1/races/events and /v1/races/results take: athlinks hits list their recent editions (event_id), runsignup hits give a race_id, raceroster hits give a numeric event_id. An empty list costs 0 credits.
List a race's events
/v1/races/events
Lists the distances of a race and the ids /v1/races/results needs. runsignup: pass race_id; every finished event of the race is listed, each with its event_id. athlinks: pass event_id (an edition from /v1/races/search); its courses are listed with course_id. raceroster: pass event_id (a results code or a numeric event id); its races are listed with course_id. An empty list costs 0 credits.
Result by bib
/v1/races/results
One runner's official result, by bib number, in one schema for all three platforms: names, chip and gun time, pace, overall, gender and age-group place, and splits where the platform publishes them. runsignup needs race_id and event_id. athlinks needs event_id and may take course_id (without it the event's courses are tried, largest first). raceroster needs event_id and may take course_id when a bib is used in more than one race. A bib that is not in the results costs 0 credits. Only what the platform's public results page shows is returned, one bib per call. A runner the platform shows as Anonymous, or whose personal data is hidden, is not named.
Race Results guides
Race Results API FAQ
How much does the Race Results API cost?
Every Race Results endpoint costs 1 credit per call by default. New accounts get 100 free credits with no card. After that, credits come in one-time packs that never expire: 25,000 for $27 and 500,000 for $297 (plus any tax). There is no subscription.
Do I need a Race Results account or developer app?
No. You call Fetchproof with one API key in the x-api-key header. It returns public Race Results data only, so there's no Race Results login, OAuth or app review.
What happens when a call fails or finds nothing?
Errors cost 0 credits, and so do cache hits on endpoints that take cache_max_age. An empty result costs 0 on Find a race and List a race's events. Each endpoint page lists its own rules.
Which Race Results data can I get?
3 endpoints: Find a race, List a race's events and Result by bib.
Is there a free trial?
Yes. Sign up with an email address to get 100 free credits, with no card. Credits never expire.
Ready to try it? Get 100 free credits or compare credit packs.