GiveSignup: API - Get Race Series Years (BETA)

RunSignup API Documentation

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

Get Race Series Years (BETA)

This API retrieves all the race_series_years information for a given race_id and event_id.

Note: This endpoint is currently in beta and subject to change.

Response Format

{
	"race_series_years": [
		{
			"race_series_year_id": 10,
			"race_series_id": 8,
			"start_year": 2024,
			"end_year": 2024,
			"age_calculation_date": "2024-12-31",
			"override_input_age_with_calc_age": "T",
			"num_best_races_included": 5,
			"overall_leaderboard_num_shown": 5,
			"show_overall_leaderboard": "T",
			"show_male_leaderboard": "T",
			"show_female_leaderboard": "T",
			"show_age_group_leaderboard": "T"
		},
		{
			"race_series_year_id": 11,
			"race_series_id": 9,
			"start_year": 2024,
			"end_year": 2024,
			"age_calculation_date": "2024-12-31",
			"override_input_age_with_calc_age": "T",
			"num_best_races_included": 5,
			"overall_leaderboard_num_shown": 5,
			"show_overall_leaderboard": "T",
			"show_male_leaderboard": "T",
			"show_female_leaderboard": "T",
			"show_age_group_leaderboard": "T"
		}
	]
}

URL

https://www.givesignup.org/rest/v2/race-series/race-series-years.json

HTTP Method

GET

Standard Parameters

Parameter	HTTP Method	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`