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:
Jun 22nd, 2018
Sales Tax & Your Race

Yesterday the US Supreme Court struck down a 1992 landmark decision (Quill Corporation vs. North Dakota) that had previously barred states from seeking sales tax from businesses unless they have a physical presence in the state. The 1992 decision had allowed online ecommerce businesses to thrive by not having to comply with the myriad and... Continue Reading →

Jun 22nd, 2018
2018 Symposium: Last Call!

With a little less than a month to the Opening Reception, we’re closing in on a sellout for the 2018 Symposium. If you’re still on the fence (or simply procrastinating), the time to register is now! Our Symposium is designed for race directors, timers, and race management/race series companies, with a variety of sessions for... Continue Reading →