A JSON-based REST API for UKA-registered Athletes. Sign up using Strava
alternative registration methods

Key Features

Some of the key features our API supports. You can always find out more from our docs.

Athletes

Get any UK athlete's basic information. Just give us their club and name and we'll do the rest.

Races

Get the full listings of any UK registerd race: competitors, times, positions, PBs and the winners of each category.

Leagues

Get all the UK athletics coaches for a particular club and get their racing results too.

Quick Start

Hopefully you'll agree, everything is nice and simple. Check out these typical use cases.

Endpoints

Athlete API provides two very simple main endpoints, responding with a well-formed JSON.

For an athlete's information:

/api/v3/athlete-info/<club>/<forename>_<surname>

Or for an athlete's race history:

/api/v3/athlete-races/<club>/<forename>_<surname>

Examples

Mo Farah runs for Newham & Essex Beagles so we'd search for Mo Farah like this:

Searhing for Mo's athlete information:

/api/v3/athlete-info/Newham+&+Essex+Beagles/Mohamed_farah

Or for Mo's race history:

/api/v3/athlete-races/Newham+&+Essex+Beagles/Mohamed_farah

The Documentation

Hopefully you'll agree, everything is nice and simple. Check out these typical use cases.

Definitive Guide

We've put together an Athlete API Definitive Guide to guide you through the whole process.

It's straightforward enough but we include some more complex examples, configuration and setup as well as downloadable demos.

API

This API covers the Athlete API server, how the JSON is created and could be consumed.

This details the server backend to process the responses. If you're only interested in the JSON endpoints, this is not the doc for you.