1. RunSignup
  2. API
  3. Methods
  4. Create or Edit Race Divisions
API Overview Getting Started API Keys Documentation API Methods Error Codes Code Examples

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.

Award Winners

The show_top_num field specifies the number of top finishers in the division who will be listed as award winners. For example, if show_top_num is set to 3, the top 3 finishers in this division will be recognized as award winners.

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://runsignup.com/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.