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.
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
Your Fetchproof API key (starts with fp_live_). Create one at app.fetchproof.com.
Query Parameters
6 parametersTiming platform: runsignup, athlinks (also carries ChronoTrack events) or raceroster.
The event or edition id from /v1/races/search or /v1/races/events.
The runner's bib number.
runsignup only: the RunSignup race id.
athlinks and raceroster: the course or race within the event, from /v1/races/events.
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.
application/jsonYYYY-MM-DD.
Null when the platform hides this runner's name.
finished, or the platform's own status.
Chip time, else gun time. As shown on the results page.
splitsobject[]required
Array itemsobject
True while the platform marks these results preliminary.
The public results page.