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:
Feb 20th, 2018
Redesigned Footers for New Race Website Template

If you haven’t switched your race to the new website template, this is yet another nudge in that direction. We have improved the footer area for the new race website to include all of the links to pages at the bottom of each page, as well as a simple “Contact This Race” link. If you... Continue Reading →

Feb 20th, 2018
New Calculation on Participant Changes

In the past when a participant moved from one event to another, and also changed their Add-Ons, we treated everything as a single transaction. This could result in someone moving to a more expensive event, but returning an add-on item and not owing anything. We have now changed that to keep the Add-Ons separate from... Continue Reading →