Skip to content

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.

01

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.

GET /v1/races/search 1 credit per call

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;
Excerpt of published sample response Full 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": [
        "{…}"
      ]
    }
  ]
}
02

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.

GET /v1/races/events 1 credit per call

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;
Excerpt of published sample response Full 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
    }
  ]
}
03

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.

GET /v1/races/results 1 credit per call

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;
Excerpt of published sample response Full 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.