Athlete Listings

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

The Athlete Listings method returns a filterable list of basic athlete objects matching the search criteria.

đźš§

Better search results available via Search API

The Search API offers a better(faster) experience if you are simply interested in searching athletes by name as it allows for misspellings and is better suited for applications allowing user input.

Setting the parameter elite=true limits returned results to only those athletes that have a current world ranking. Many of the parameters accept a pipe delimited list to allow selection of multiple categories/athlete_ids.

The name parameter allows a fuzzy search by both first name or last name.

The following example retrieves all female elite triathletes from the United States of America.

curl --header "apikey: [[app:key]]" https://api.triathlon.org/v1/athletes?elite=true&country_id=293&gender=female

The validated parameter indicates whether the athlete's data has been verified by ITU officials.

Query Params
int32
Defaults to 10

How many athletes to be returned per page

int32

The page number to be returned

string

A pipe delimited list of category ids

string

Restrict returned athletes by name

string

A pipe delimited list of country ids

string

Restrict returned athletes by gender (male|female)

string

Restrict athletes to those on world rankings

string

A pipe delimited list of athlete ids

boolean

Filter whether the athlete data has been validated

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json