Skip to main content

Overview

Generate presigned download URLs for the original, unwatermarked photos belonging to a participant. Choose one of four ways to identify the photos via the method field. The shape of identifier depends on method:
Selling photos, or having a coding agent build a store? Follow Sell Originals in the 9pic-integration skill: request originals only from your backend after your own payment confirms the sale, and keep the gallery on previews.
  • bib — identifier is a BIB number string (from 9Pic BibTrack / BIB Search).
  • selfie — identifier is a request_id string returned by 9Pic FaceFind (Face Search).
  • image_id — identifier is a single image ID string (for example, an image_id returned by All Photos, BIB Search, or Face Search).
  • image_ids — identifier is 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

The server attempts to generate a presigned URL for the single requested image_id. If the image does not exist in storage, the API responds with 400 Bad Request (see Error Responses).

image_ids body

The server attempts to generate presigned URLs for each requested 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

To download by BIB instead, send {"method": "bib", "identifier": "1234"}.

Example: download by image_id

Example: download by image_ids

Example Response

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.