Overview
Generate presigned download URLs for the original, unwatermarked photos belonging to a participant. Choose one of four ways to identify the photos via themethod field. The shape of identifier depends on method:
bib—identifieris a BIB number string (from 9Pic BibTrack / BIB Search).selfie—identifieris arequest_idstring returned by 9Pic FaceFind (Face Search).image_id—identifieris a single image ID string (for example, animage_idreturned by All Photos, BIB Search, or Face Search).image_ids—identifieris a non-empty list of image ID strings.
Presigned URLs are time-limited and typically expire within ~1 hour. Generate them on demand rather than caching them in your client storage. Only large/original images are returned.
Endpoint
Path Parameters
Query Parameters
This endpoint returns paginated results. See the Pagination Model.
Request Body
identifier shape by method
image_id body
image_id. If the image does not exist in storage, the API responds with 400 Bad Request (see Error Responses).
image_ids body
image_id. Image IDs that do not exist in storage are returned in failed_urls, while valid ones are returned in presigned_urls. If every requested image ID is invalid, the API responds with 400 Bad Request (see Error Responses).
For bib and selfie, the response is 200 even when some or all original files are missing from storage: those photos are listed in failed_urls. Always check successful_count and failed_urls before you tell a buyer their files are ready.
Example Request
{"method": "bib", "identifier": "1234"}.
Example: download by image_id
Example: download by image_ids
Example Response
- bib / selfie
- image_id (single)
- image_ids (mixed)
- image_ids (all invalid)
Response Models
To access the full set, page through the
presigned_urls array using page and page_size.
Error Responses
See Errors for canonical descriptions and retry guidance.

