GiveSignup: API - Get Bib Validation Settings

RunSignup API Documentation

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

Get Bib Validation Settings

Get bib validation settings for events in a given year. The response will list all events within the specified Race Event Days ID and includes an array of bib ranges that are defined for each event.

Response Format

{
	"events": [
		{
			"event_id": 123,
			"bib_ranges": [
				{
					"starting_bib_num": 100,
					"ending_bib_num": 500
				},
				{
					"starting_bib_num": 700,
					"ending_bib_num": 850
				}
			]
		},
		{
			"event_id": 456,
			"bib_ranges": []
		}
	]
}

URL

https://www.givesignup.org/rest/race/:race_id/get-bib-validation-settings

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`
`race_event_days_id` Required	GET		Race event days ID. This ID groups together events, typically by year. This ID is returned with the event information in the APIs to get races or a single race.	`uint`