Skip to main content

Overview

The Memories surface is the event-scoped photo and video API. Endpoints are grouped by use:
Building a participant-facing gallery or search app? Follow the Participant App guide (coding agents get it in the 9pic-integration skill): call the API only from your backend, save each search ID, check Event Details first, keep one search identifier per search, and show previews rather than originals.
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.
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).

Participant-facing app

  1. Confirm the event has the right discovery features enabled with Event Details.
  2. Render the gallery with All Photos, or time-based discovery with Photo Timeline.
  3. Offer BIB Search (9Pic BibTrack) for runners who know their bib, and Face Search (9Pic FaceFind) for selfie-based discovery.
  4. Optionally start Video Clipping Search (9Pic Motion) using the same request_id returned by Face Search to power photo and video discovery from a single selfie upload.
  5. When the participant is ready to download, hand the request_id (with method: "selfie") or BIB number (with method: "bib") to Download Originals.

Pipeline (organiser automation)

  1. Import to import from configured sources.
  2. Poll Pipeline Status until import is complete.
  3. Process to run watermarking, BIB detection, and face indexing.
  4. Poll until processing is complete, then Go Live to publish.
  5. Poll until go-live is complete (is_live: true) before relying on browse, search, or download endpoints.