RunSignup: API - Get Race Photos

RunSignup API Documentation

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

Get Race Photos

Use this API to get race photos.

Response Format

{
	"photos": [
		{
			"photo_id": 1,
			"album_id": 21,
			"race_event_days_id": 6568,
			"bibs": [
				1179
			],
			"original": {
				"image_url": "https:\/\/rsu-photos-v2-v2prod.s3.amazonaws.com\/customOriginal_v3\/race_21_6568_d375c60e-ba56-49b5-8812-82b597eef456.jpg",
				"height": 1067,
				"width": 1600
			},
			"thumbnail": {
				"image_url": "https:\/\/rl13photo5788d40734058.s3.amazonaws.com\/thumbs_v2\/race_21_6568_d375c60e-ba56-49b5-8812-82b597eef456.jpg",
				"height": 200,
				"width": 300
			},
			"large": {
				"image_url": "https:\/\/rsu-photos-v2-v2prod.s3.amazonaws.com\/large_watermarked_v3\/race_21_6568_d375c60e-ba56-49b5-8812-82b597eef456.jpg",
				"height": 600,
				"width": 900
			},
			"uploaded_filename": "myPhoto.jpg",
			"uploaded_ts": 1593547220
		},
		{
			"photo_id": 41,
			"album_id": 21,
			"race_event_days_id": 6827,
			"bibs": [
				1145,
				1308,
				1425
			],
			"original": {
				"image_url": "https:\/\/rl13photo5788d40734058.s3.amazonaws.com\/original_v2\/race_21_6568_d35026d1-3ad0-4e77-a374-ae95c0582c25.jpg",
				"height": 1200,
				"width": 1062
			},
			"thumbnail": {
				"image_url": "https:\/\/rl13photo5788d40734058.s3.amazonaws.com\/thumbs_v2\/race_21_6568_d35026d1-3ad0-4e77-a374-ae95c0582c25.jpg",
				"height": 300,
				"width": 266
			},
			"large": {
				"image_url": "https:\/\/rsu-photos-v2-v2prod.s3.amazonaws.com\/large_watermarked_v3\/race_21_6568_d35026d1-3ad0-4e77-a374-ae95c0582c25.jpg",
				"height": 900,
				"width": 797
			},
			"uploaded_filename": "myPhoto2.jpg",
			"uploaded_ts": 1593547222
		}
	]
}

URL

https://runsignup.com/rest/v2/photos/get-race-photos.json

HTTP Method

GET

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`
`rsu_api_key` Required	GET		API key	`string`
`X-RSU-API-SECRET` Required	HTTP Header		API secret	`string`
`uploaded_since_timestamp`	GET		Uploaded since timestamp.	`int`
`page`	GET	1	Page.	`int`
`num`	GET	100	Number of results requested per page.	`int`
`include_participant_uploads`	GET	T	Should photos uploaded by participants be included.	`string`
`generic_photo_album_id`	GET		Generic photo album ID.	`int`