How to get race results by bib number with an API
Updated · 3 steps
Race timing platforms each publish results on their own sites, in their own formats. Fetchproof reads the public results on RunSignup, Athlinks (which also carries ChronoTrack events) and Race Roster, and returns one runner's result in the same schema for all three.
Use it to show results in a training app, verify finish times for a challenge, or build a club leaderboard. It takes three calls: find the race, pick the distance, then look up the bib.
Find the race
Search finished races by name on one platform, optionally limited to a year. Each hit carries the ids the next calls need: Athlinks hits list recent editions with their event_id, RunSignup hits give a race_id, and Race Roster hits give a numeric event_id.
cURL
curl --request GET 'https://api.fetchproof.com/v1/races/search?platform=athlinks&query=chicago+marathon&year=2025' \
--header 'x-api-key: YOUR_API_KEY' JavaScript
const response = await fetch("https://api.fetchproof.com/v1/races/search?platform=athlinks&query=chicago+marathon&year=2025", {
method: 'GET',
headers: {
'x-api-key': process.env.FETCHPROOF_API_KEY,
},
});
const data = await response.json();
console.log(data); Python
import os
import requests
response = requests.get(
"https://api.fetchproof.com/v1/races/search?platform=athlinks&query=chicago+marathon&year=2025",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json()) Go
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/races/search?platform=athlinks&query=chicago+marathon&year=2025", nil)
req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
} PHP
<?php
$ch = curl_init("https://api.fetchproof.com/v1/races/search?platform=athlinks&query=chicago+marathon&year=2025");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response; {
"success": true,
"credits_remaining": 100,
"credits_charged": 1,
"platform": "athlinks",
"query": "chicago marathon",
"year": 2025,
"events": [
{
"platform": "athlinks",
"race_id": null,
"event_id": "1131559",
"name": "Bank of America Chicago Marathon",
"date": "2025-10-12",
"city": "Chicago",
"state": "IL",
"url": "https://www.athlinks.com/event/96107",
"editions": [
"{…}"
]
}
]
} List the race's distances
For Athlinks and Race Roster, pass the event_id to list its courses, each with a course_id, name, distance_meters and finisher count. For RunSignup, pass race_id to list every finished event of the race, each with its event_id.
cURL
curl --request GET 'https://api.fetchproof.com/v1/races/events?platform=athlinks&event_id=1131559' \
--header 'x-api-key: YOUR_API_KEY' JavaScript
const response = await fetch("https://api.fetchproof.com/v1/races/events?platform=athlinks&event_id=1131559", {
method: 'GET',
headers: {
'x-api-key': process.env.FETCHPROOF_API_KEY,
},
});
const data = await response.json();
console.log(data); Python
import os
import requests
response = requests.get(
"https://api.fetchproof.com/v1/races/events?platform=athlinks&event_id=1131559",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json()) Go
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/races/events?platform=athlinks&event_id=1131559", nil)
req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
} PHP
<?php
$ch = curl_init("https://api.fetchproof.com/v1/races/events?platform=athlinks&event_id=1131559");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response; {
"success": true,
"credits_remaining": 100,
"credits_charged": 1,
"platform": "athlinks",
"event_id": "1131559",
"race_name": "Bank of America Chicago Marathon",
"date": "2025-10-12",
"events": [
{
"platform": "athlinks",
"race_id": null,
"event_id": "1131559",
"course_id": "2662807",
"name": "Marathon",
"date": "2025-10-12",
"distance": null,
"distance_meters": 42165,
"finishers": 54108
}
]
} Get the runner's result by bib
Pass the ids and the bib. The result has the runner's name, gender and age, official_time, chip_time and gun_time (each also in seconds), pace, overall_place, gender_place and age_group_place with their totals, splits where the platform publishes them, and the source_url of the results page.
RunSignup needs race_id and event_id. Athlinks needs event_id, and if you leave out course_id the event's courses are tried, largest first. Race Roster needs event_id, plus course_id when a bib appears in more than one race.
cURL
curl --request GET 'https://api.fetchproof.com/v1/races/results?platform=athlinks&event_id=1131559&bib=6&course_id=2662807' \
--header 'x-api-key: YOUR_API_KEY' JavaScript
const response = await fetch("https://api.fetchproof.com/v1/races/results?platform=athlinks&event_id=1131559&bib=6&course_id=2662807", {
method: 'GET',
headers: {
'x-api-key': process.env.FETCHPROOF_API_KEY,
},
});
const data = await response.json();
console.log(data); Python
import os
import requests
response = requests.get(
"https://api.fetchproof.com/v1/races/results?platform=athlinks&event_id=1131559&bib=6&course_id=2662807",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json()) Go
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/races/results?platform=athlinks&event_id=1131559&bib=6&course_id=2662807", nil)
req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
} PHP
<?php
$ch = curl_init("https://api.fetchproof.com/v1/races/results?platform=athlinks&event_id=1131559&bib=6&course_id=2662807");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response; {
"success": true,
"credits_remaining": 100,
"credits_charged": 1,
"platform": "athlinks",
"event_id": "1131559",
"race_id": null,
"course_id": "2662807",
"race_name": "Bank of America Chicago Marathon",
"event_name": "Marathon",
"date": "2025-10-12",
"distance": null,
"distance_meters": 42165,
"…": "26 more fields"
} What it costs
Each call costs 1 credit. A search or event list that finds nothing costs 0, and so does a bib that isn't in the results. A cache hit with cache_max_age costs 0.
Limits
One bib per call. Only what the platform's public results page shows is returned. A runner the platform shows as Anonymous, or whose personal data is hidden, isn't named. Splits appear only where the timing platform publishes them. Check the preliminary flag before you treat a result as final.
Try it with 100 free credits
Sign up with an email address, no card. Credits never expire. Errors cost 0 credits, and each endpoint page lists exactly what it charges.