Use this API to get race photos.
{
"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
}
]
}
| Parameter | HTTP Method | Default | Description | Datatype |
|---|---|---|---|---|
race_idRequired |
GET | ID of race. | uint |
|
race_event_days_idRequired |
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 |
|
api_key |
GET | API key. | string |
|
api_secret |
GET | 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 |
|
X-RSU-API-SECRET |
HTTP Header | Super partner API key. If used, you must send the API secret in an HTTP header named X-RSU-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 |
{
"openapi": "3.0.3",
"info": {
"title": "Get Race Photos",
"description": "Get all photos for a race event day.",
"version": "1.0.0",
"contact": {
"name": "RunSignup API Support",
"url": "https://runsignup.com/API",
"email": "info@runsignup.com"
}
},
"servers": [
{
"url": "https://api.runsignup.com/rest",
"description": "Production API Server"
}
],
"tags": [
{
"name": "Race Photos",
"description": "APIs related to Race Photos"
}
],
"components": {
"schemas": {
"Error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Error message"
},
"details": {
"type": "object",
"description": "Additional error details",
"additionalProperties": true
}
},
"required": [
"error"
]
},
"BadRequestError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating invalid request parameters or structure"
}
]
},
"UnauthorizedError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating authentication failure"
}
]
},
"ForbiddenError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating the authenticated user lacks required permissions"
}
]
},
"NotFoundError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating the requested resource does not exist"
}
]
},
"ServerError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating an unexpected server-side issue"
}
]
}
},
"securitySchemes": {
"apiKey": {
"type": "apiKey",
"in": "query",
"name": "api_key",
"description": "RunSignup API Key"
},
"apiSecret": {
"type": "apiKey",
"in": "query",
"name": "api_secret",
"description": "RunSignup API Secret"
}
}
},
"paths": {
"/v2/photos/get-race-photos.json": {
"get": {
"tags": [
"Race Photos"
],
"summary": "Get Race Photos",
"description": "Get all photos for a race event day.",
"operationId": "v2_photos_get_race_photos_json",
"parameters": [
{
"name": "race_id",
"in": "query",
"description": "ID of race.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "race_event_days_id",
"in": "query",
"description": "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.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "api_key",
"in": "query",
"description": "API key.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "api_secret",
"in": "query",
"description": "API secret.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "rsu_api_key",
"in": "query",
"description": "API v2 key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "X-RSU-API-SECRET",
"in": "header",
"description": "Super partner API key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "uploaded_since_timestamp",
"in": "query",
"description": "Uploaded since timestamp.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "page",
"in": "query",
"description": "Page.",
"required": false,
"schema": {
"type": "integer",
"default": "1"
}
},
{
"name": "num",
"in": "query",
"description": "Number of results requested per page.",
"required": false,
"schema": {
"type": "integer",
"default": "100"
}
},
{
"name": "include_participant_uploads",
"in": "query",
"description": "Should photos uploaded by participants be included.",
"required": false,
"schema": {
"type": "string",
"default": "T"
}
},
{
"name": "generic_photo_album_id",
"in": "query",
"description": "Generic photo album ID.",
"required": false,
"schema": {
"type": "integer"
}
}
],
"security": [
{
"apiKey": [],
"apiSecret": []
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BadRequestError"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedError"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ForbiddenError"
}
}
}
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundError"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServerError"
}
}
}
}
},
"x-permissions": [
"affiliates",
"partners",
"race_directors",
"timers"
]
}
}
}
}
