1. RunSignup
  2. API
  3. Methods
  4. Get Race Groups/Teams Types

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:

<?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://www.givesignup.org/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

If you continue to use this site, you consent to use all cookies. We use cookies to offer you a better browsing experience. Read how we use cookies and how you can control them by visiting our Privacy Policy.

If you continue to use this site, you consent to use all cookies.