RunSignup: API - Get Race Groups/Teams Types

RunSignup API Documentation

API Overview Getting Started API Keys Documentation API Methods Error Codes Code Examples

Get Race Groups/Teams Types

Get information on race group/team types. The IDs in the response are required when viewing existing teams/groups and when adding or updating groups/teams.

An XML response will look similar to this example:

xxxxxxxxxx
 
<?xml version="1.0" encoding="utf-8" ?><!DOCTYPE events PUBLIC "-//RunSignUp//API" "/rest/rsu.dtd"><race_team_types>    <race_team_type>        <team_type_id>1123</team_type_id>        <team_type>Competitive Team</team_type>        <team_type_desc>Competitive Team Description</team_type_desc>        <min_members>0</min_members>        <max_members></max_members>        <min_male_members>1</min_male_members>        <max_male_members></max_male_members>        <min_female_members>1</min_female_members>        <max_female_members></max_female_members>        <max_num_teams></max_num_teams>        <valid_event_ids>            <event_id>11428</event_id>            <event_id>11429</event_id>        </valid_event_ids>        <require_gender_selection>T</require_gender_selection>        <allow_all_male_team>T</allow_all_male_team>        <allow_all_female_team>T</allow_all_female_team>        <allow_coed_team>F</allow_coed_team>        <allow_nonbinary_in_male_or_female>F</allow_nonbinary_in_male_or_female>        <require_age_range_selection>F</require_age_range_selection>        <team_age_restrictions>            <team_age_restriction>                <team_age_restriction_id>153</team_age_restriction_id>                <min_age>0</min_age>                <max_age>10</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>154</team_age_restriction_id>                <min_age>11</min_age>                <max_age>15</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>155</team_age_restriction_id>                <min_age>16</min_age>                <max_age>19</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>156</team_age_restriction_id>                <min_age>20</min_age>                <max_age>29</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>157</team_age_restriction_id>                <min_age>30</min_age>                <max_age>39</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>158</team_age_restriction_id>                <min_age>40</min_age>                <max_age>49</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>159</team_age_restriction_id>                <min_age>50</min_age>                <max_age>59</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>160</team_age_restriction_id>                <min_age>60</min_age>                <max_age>69</max_age>            </team_age_restriction>            <team_age_restriction>                <team_age_restriction_id>161</team_age_restriction_id>                <min_age>70</min_age>                <max_age>999</max_age>            </team_age_restriction>        </team_age_restrictions>    </race_team_type>    <race_team_type>        <team_type_id>1143</team_type_id>        <team_type>Social Team</team_type>        <team_type_desc>This is just a simple grouping of friends.</team_type_desc>        <min_members>0</min_members>        <max_members></max_members>        <min_male_members>0</min_male_members>        <max_male_members></max_male_members>        <min_female_members>0</min_female_members>        <max_female_members></max_female_members>        <max_num_teams></max_num_teams>        <valid_event_ids>            <event_id>11428</event_id>            <event_id>11429</event_id>            <event_id>11430</event_id>        </valid_event_ids>        <require_gender_selection>F</require_gender_selection>        <allow_all_male_team>T</allow_all_male_team>        <allow_all_female_team>T</allow_all_female_team>        <allow_coed_team>T</allow_coed_team>        <allow_nonbinary_in_male_or_female>T</allow_nonbinary_in_male_or_female>        <require_age_range_selection>F</require_age_range_selection>        <team_age_restrictions></team_age_restrictions>    </race_team_type></race_team_types>

In this response, "require_gender_selection" is "T" or "F" to indicate whether or not gender selection is required when creating a new team. The "require_age_range_selection" field is "T" or "F" to indicate whether or not age range selection is required.

URL

https://runsignup.com/rest/race/:race_id/teams/team-types

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`
`rsu_api_key`	GET		API v2 key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET.	`string`
`sp_api_key`	GET		Super partner API key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET.	`string`
`X-RSU-API-SECRET`	HTTP Header		API v2 or super partner secret.	`string`
`format`	GET	xml	Format of response. The default if not sent is `xml`, but `json` is preferred.	`format`

Parameters

Parameter	HTTP Method	Default	Description	Datatype
`race_id` Required	GET		ID of race.	`uint`
`event_id` Required	GET		ID of event or list of event IDs separated by commas.	`id_list`