Skip to content
OpenAPI JSON ↗

Race Results · Result by bib

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.

1 credit per request0 credits on error & cache
GET
/v1/races/results

Credit Cost & Caching

View credit packs ↗

Default: 1 credit

An empty result costs 0 credits.

How charges are determined

Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.

A call that fails costs 0 credits. A result served from cache costs 0 credits.

`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.

A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).

A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.

Cache control

Serve a cached response when it is newer than this. A cache hit costs 0 credits.

Pagination

Check cursor / page parameters and response fields below.

Authorizations · Headers

x-api-keystringheaderrequired

Your Fetchproof API key (starts with fp_live_). Create one at app.fetchproof.com.

Query Parameters

6 parameters
platformstringqueryrequired

Timing platform: runsignup, athlinks (also carries ChronoTrack events) or raceroster.

Available options:runsignupathlinksraceroster
Example:athlinks
event_idstringqueryrequired

The event or edition id from /v1/races/search or /v1/races/events.

Example:1131559
bibstringqueryrequired

The runner's bib number.

Example:6
race_idstringqueryoptional

runsignup only: the RunSignup race id.

course_idstringqueryoptional

athlinks and raceroster: the course or race within the event, from /v1/races/events.

cache_max_agestringqueryoptional

Serve a cached response when it is newer than this. A cache hit costs 0 credits.

Response Schemas

200Success. Envelope: success / credits_remaining / credits_charged. An empty page costs 0 credits.
Content-Typeapplication/json
object
successbooleanrequired
credits_remainingintegerrequired
credits_chargedintegerrequired
platformstringrequired
event_idstringrequired
race_idstringoptional
course_idstringoptional
race_namestringoptional
event_namestringoptional
datestringoptional

YYYY-MM-DD.

distancestringoptional
distance_metersintegeroptional
bibstringrequired
namestringoptional

Null when the platform hides this runner's name.

first_namestringoptional
last_namestringoptional
genderstringoptional
ageintegeroptional
age_groupstringoptional
statusstringoptional

finished, or the platform's own status.

official_timestringrequired

Chip time, else gun time. As shown on the results page.

official_time_secondsnumberoptional
chip_timestringoptional
chip_time_secondsnumberoptional
gun_timestringoptional
gun_time_secondsnumberoptional
pacestringoptional
pace_unitstringoptional
pace_secondsnumberoptional
overall_placeintegeroptional
overall_totalintegeroptional
gender_placeintegeroptional
gender_totalintegeroptional
age_group_placeintegeroptional
age_group_totalintegeroptional
splitsobject[]required
Array itemsobject
namestringoptional
timestringoptional
pacestringoptional
preliminarybooleanoptional

True while the platform marks these results preliminary.

source_urlstringoptional

The public results page.

401Invalid or missing x-api-key
402No credits remaining
404Resource not found. Costs 0 credits.
GET

/v1/races/results

Parameters

string query required

Timing platform: runsignup, athlinks (also carries ChronoTrack events) or raceroster.

string query required

The event or edition id from /v1/races/search or /v1/races/events.

string query required

The runner's bib number.

string query

runsignup only: the RunSignup race id.

string query

athlinks and raceroster: the course or race within the event, from /v1/races/events.

string query

Serve a cached response when it is newer than this. A cache hit costs 0 credits.

Request URL

https://api.fetchproof.com/v1/races/results

Snippets use a $FETCHPROOF_API_KEY placeholder. To run a live call, use the dashboard Playground.

 
↑↓ navigate · ↵ open · esc close