Overview
The Memories surface is the event-scoped photo and video API. Endpoints are grouped by use:
Every endpoint except Unpublish accepts an
X-API-Key header; Unpublish is OAuth-only. See Authentication for which endpoints accept OAuth, and Conventions for the shared response envelope and identifier rules.
The consumer-facing endpoints surface four 9Pic AI products:
Browse Photos
Render the full event gallery or jump to a specific image without filtering by BIB or selfie.All Photos
GET /event/{event_id}/images — full paginated photo gallery for an event, ordered by capture timestamp.Image Details
GET /event/{event_id}/images/{image_id} — one photo and its curated metadata by image ID.Photo Timeline
GET /event/{event_id}/timeline/days and GET /event/{event_id}/timeline/images — browse photos by capture time with day/hour buckets and windowed pagination.Search
Participant discovery by BIB number (9Pic BibTrack) or selfie (9Pic FaceFind).BIB Search
GET /event/{event_id}/bibs/{bib} — photos tagged with a participant’s BIB number.Face Search
POST /event/{event_id}/faces — upload a selfie and get matching photos. Reuse the returned request_id for cached pagination and downloads.Video
Personalised video clips powered by 9Pic Motion.Video Clipping Search
POST /event/{event_id}/video-clipping/search-by-selfie, /search-by-bib or /search-by-name — async pipeline that returns clips (HLS playback, MP4 download) of moments where the participant appears, or the participant’s whole video on video name search events.Downloads
Presigned URLs for original (unwatermarked) files — the download side of 9Pic Stamp.Download Originals
POST /event/{event_id}/original-photos — presigned URLs keyed by BIB, selfie request_id, single image_id, or a list of image IDs.Pipeline (photos)
Organiser-side import → process → publish workflow. Trigger stages, then poll status until each completes.Pipeline Status
GET /event/{event_id}/pipeline/photos/status — poll import, processing, and go-live stage status.Import Photos
POST /event/{event_id}/pipeline/photos/import — import photos from configured sources (step 1).Process Photos
POST /event/{event_id}/pipeline/photos/process — run AI processing (step 2).Go Live
POST /event/{event_id}/pipeline/photos/go-live — publish processed photos to the public gallery (step 3).Unpublish
POST /event/{event_id}/pipeline/photos/unpublish — move a live gallery back to draft (OAuth only).Recommended Flow
Participant-facing app
- Confirm the event has the right discovery features enabled with Event Details.
- Render the gallery with All Photos, or time-based discovery with Photo Timeline.
- Offer BIB Search (9Pic BibTrack) for runners who know their bib, and Face Search (9Pic FaceFind) for selfie-based discovery.
- Optionally start Video Clipping Search (9Pic Motion) using the same
request_idreturned by Face Search to power photo and video discovery from a single selfie upload. - When the participant is ready to download, hand the
request_id(withmethod: "selfie") or BIB number (withmethod: "bib") to Download Originals.
Pipeline (organiser automation)
- Import to import from configured sources.
- Poll Pipeline Status until import is complete.
- Process to run watermarking, BIB detection, and face indexing.
- Poll until processing is complete, then Go Live to publish.
- Poll until go-live is complete (
is_live: true) before relying on browse, search, or download endpoints.

