Race data API

Race dates, entry status and results links, as JSON.

Two read-only endpoints cover 2,000+ marathons, halves and ultras, each checked against the race’s own pages. Free with a key.

Get a free key Using an AI assistant? Try the MCP server

Search races

GET https://marathonscout.com/api/v1/races?query=chicago&distance=marathon
GET https://marathonscout.com/api/v1/races?country=US&region=Ohio&from=2027-03-01&to=2027-05-31
Authorization: Bearer msk_…

Parameter	Meaning
`query`	Race name or place, e.g. chicago or big sur.
`distance`	marathon, half_marathon or ultramarathon.
`country`	ISO code or English name, e.g. US or Japan.
`region`	State or region as written locally, e.g. Ohio or Bavaria.
`from, to`	Next race date window, YYYY-MM-DD.
`boston_qualifier`	true for Boston qualifying courses only.
`limit`	1 to 20 races.

One race

GET https://marathonscout.com/api/v1/races/new-york-city-marathon

Returns every stored date, the next edition’s registration status with when we checked it, Boston-qualifier status, and registration, results and live tracking links. Links are stable marathonscout.com/go URLs that open the current official page, with the destination in official_url. See a sample response.

Limits and terms

200 calls a day and 20 a minute per key, shared with the MCP server.
Up to 150 different races a day per key.
Credit “Race data from Marathon Scout”, send runners to official pages for entry, and don’t cache for more than 24 hours.
Full API terms. Need more? Email marathonscout@agentmail.to.

Common questions

Is there a free marathon race API?

Yes. Marathon Scout's race data API is free with a key we email you, for up to 200 calls a day.

Does the API say whether registration is open?

Yes, for the edition it applies to, with the time we last checked it on the race's own pages. unknown means not confirmed, never closed.

Can I download the whole race database?

No. The API is for looking races up as your users need them, not for copying the directory. Email us if you need bulk data.