RunSignUp

RunSignUp API Documentation

Get Races

Gets a list of races, with information similar to Get Race, except that only the most current events are listed. Event start and end times are in the timezone of the race. All other dates/times are in Eastern Time. The races are separated into pages. The maximum number of races per page is 1,000.

URL

https://runsignup.com/rest/races

HTTP Method

GET

Standard Parameters

Parameter HTTP Method Default Description Datatype
api_key GET API Key string
api_secret GET API Secret string
tmp_key GET Temporary API Key from login API call. This should NOT be used in combination with API Key. string
tmp_secret GET Temporary API Secret from login API call. This should NOT be used in combination with API Secret. string
format GET xml Format of response. format

Parameters

Parameter HTTP Method Default Description Datatype
aflt_token GET If set, this affiliate token will be appended to race URLs. string
events GET F Includes race events in the output. bool
race_headings GET F Include race headings in the output. bool
include_waiver GET F Should waiver be included. bool
include_event_days GET F Should information on events days (e.g. each race year) be included. bool
page GET 1 Page number to get. uint
results_per_page GET 50 Number of results per page. uint
sort GET name ASC Sort by "name", "date", or "end_date" in ascending ("ASC") or descending ("DESC") order. string

Search

Parameter HTTP Method Default Description Datatype
name GET Search by race name. string
start_date GET today Current Date Searches for races that occur on or after a given date. date
end_date GET Searches for races that occur on or before a given date. date
created_since GET Searches for races that were created on or after a given date. date
created_on_or_before GET Searches for races that were created on or before a given date. date
modified_since GET Searches for races that were modified on or after a given date. date
modified_on_or_before GET Searches for races that were modified on or before a given date. date
only_partner_races GET F Only get races linked to the partner using the API. bool
search_start_date_only GET F Only search race races based on start date, not end date. bool
only_races_with_results GET F Only get races that have results. bool
city GET Search by city. string
state GET Search by state. state
country GET Search by country. country
event_type GET Get races by event type. event_type
min_distance GET Minimum race distance to get. float
max_distance GET Maximum race distance to get. float
distance_units GET K Units to use with distance. distance_units
zipcode GET Searches for races within radius(required) miles from zipcode. US Only. string
radius GET Searches for races within radius miles from zipcode(required). uint

Try It Now!

E-Mail
From Our Blog:
Sep 21st, 2017
The Risks of Declining Registrations

There was a recent article on Bloomberg News suggesting that the next financial crisis could start in Silicon Valley and “Fintech”. Fintech is a broad term, but touches all races who use online registration with the movement of over $1 Billion per year thru the 100 or so race registration systems. Here are some of … Continue reading "The Risks of Declining Registrations"

Sep 21st, 2017
Child Privacy

To protect the data the races who use as as their online registration platform, we have made some updates to your race, event and club websites to better protect the online privacy of children, particularly those under the age of 13. Our updates are designed with the Children’s Online Privacy Protection Rule (“COPPA”) in mind and … Continue reading "Child Privacy"