Create or Edit Race Divisions

Use this API to create or edit divisions for an event. Divisions with a race_division_id set will be treated as an edit, otherwise a new division will be created. Each division must include a division_priority. Use the division_external_identifier field to identify the source of the division. It can be a string or JSON format and should be 128 characters or less. The request format is below.

Request Format

{
	"division_placement_field": "clock_time",
	"overall_division": {
		"awards_for_top_num": 3,
		"time_display_field": null
	},
	"race_divisions": [
		{
			"race_division_id": null,
			"division_name": "Female 1-19",
			"division_short_name": "F0119",
			"show_top_num": 3,
			"division_priority": 1,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|1",
			"auto_selection_criteria": {
				"min_age": 1,
				"max_age": 19,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Female 20-29",
			"division_short_name": "F2029",
			"show_top_num": 3,
			"division_priority": 2,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|2",
			"auto_selection_criteria": {
				"min_age": 20,
				"max_age": 29,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Female 30-39",
			"division_short_name": "F3039",
			"show_top_num": 3,
			"division_priority": 3,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|3",
			"auto_selection_criteria": {
				"min_age": 30,
				"max_age": 39,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Female 40-49",
			"division_short_name": "F4049",
			"show_top_num": 3,
			"division_priority": 4,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|4",
			"auto_selection_criteria": {
				"min_age": 40,
				"max_age": 49,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Female 50-59",
			"division_short_name": "F5059",
			"show_top_num": 3,
			"division_priority": 5,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|5",
			"auto_selection_criteria": {
				"min_age": 50,
				"max_age": 59,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Female 60-69",
			"division_short_name": "F6069",
			"show_top_num": 3,
			"division_priority": 6,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|6",
			"auto_selection_criteria": {
				"min_age": 60,
				"max_age": 69,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Female 70-79",
			"division_short_name": "F7079",
			"show_top_num": 3,
			"division_priority": 7,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|7",
			"auto_selection_criteria": {
				"min_age": 70,
				"max_age": 79,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Female 80-99",
			"division_short_name": "F8099",
			"show_top_num": 3,
			"division_priority": 8,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|8",
			"auto_selection_criteria": {
				"min_age": 80,
				"max_age": 99,
				"gender": "F"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 1-19",
			"division_short_name": "M0119",
			"show_top_num": 3,
			"division_priority": 9,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|9",
			"auto_selection_criteria": {
				"min_age": 1,
				"max_age": 19,
				"gender": "M"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 20-29",
			"division_short_name": "M2029",
			"show_top_num": 3,
			"division_priority": 10,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|10",
			"auto_selection_criteria": {
				"min_age": 20,
				"max_age": 29,
				"gender": "M"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 30-39",
			"division_short_name": "M3039",
			"show_top_num": 3,
			"division_priority": 11,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|11",
			"auto_selection_criteria": {
				"min_age": 30,
				"max_age": 39,
				"gender": "M"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 40-49",
			"division_short_name": "M4049",
			"show_top_num": 3,
			"division_priority": 12,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|12",
			"auto_selection_criteria": {
				"min_age": 40,
				"max_age": 49,
				"gender": "M"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 50-59",
			"division_short_name": "M5059",
			"show_top_num": 3,
			"division_priority": 13,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|13",
			"auto_selection_criteria": {
				"min_age": 50,
				"max_age": 59,
				"gender": "M"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 60-69",
			"division_short_name": "M6069",
			"show_top_num": 3,
			"division_priority": 14,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|14",
			"auto_selection_criteria": {
				"min_age": 60,
				"max_age": 69,
				"gender": "M"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 70-79",
			"division_short_name": "M7079",
			"show_top_num": 3,
			"division_priority": 15,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|15",
			"auto_selection_criteria": {
				"min_age": 70,
				"max_age": 79,
				"gender": "M"
			}
		},
		{
			"race_division_id": null,
			"division_name": "Male 80-99",
			"division_short_name": "M8099",
			"show_top_num": 3,
			"division_priority": 16,
			"allow_winner_of_higher_priority": "F",
			"hidden_in_main_results": "F",
			"time_display_field": null,
			"division_external_identifier": "rdscoring|age_group|16",
			"auto_selection_criteria": {
				"min_age": 80,
				"max_age": 99,
				"gender": "M"
			}
		},
	]
}

URL

https://www.givesignup.org/rest/v2/divisions/manage-divisions.json

HTTP Method

POST

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

Parameters

Parameter HTTP Method Default Description Datatype
race_id
Required
GET Race ID. uint
event_id
Required
GET Event ID. uint
request
Required
POST JSON containing request data. string

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.