X-API-Key header you can list events, fetch event photos, run 9Pic BibTrack searches by BIB number, run 9Pic FaceFind selfie searches, generate 9Pic Motion video clips, and produce presigned download links for originals.
Base URL
/api/v1/ext/.... Read the Conventions page for response envelopes, identifiers, pagination, and idempotency rules. Read the Errors page for status codes.
Quickstart
1
Create an API key
Open Developer Zone in the 9Pic dashboard sidebar and click Create Token. Copy the key once — it is shown only at creation time. See Authentication for token management.
2
Find your org_id and event_id
Your
org_id is shown in the top-left organisation selector. Each event_id appears next to its event in the event list. You can also fetch them programmatically with List Events.3
Make your first request
Ping is the safest first call — it validates your API key, host, and event mapping in one round trip.A successful response is
200 OK with { "status": "ok", "org_id": 903, "event_id": 456 }.4
Fetch events and photos
Once Ping returns
200, you can call List Events, All Photos, or any of the search endpoints below.Start Here
Authentication
Create, manage, and rotate API keys.
Conventions
Base URL, identifiers, response envelopes, and pagination.
Errors
Status codes, common causes, and retry guidance.
Ping
Verify your integration end to end.
Events
List Events
Paginated list of events for your organisation.
Event Details
Event metadata and enabled search capabilities.
Memories
Event photos and videos live under Memories, grouped by use in the sidebar.Browse Photos
All Photos
Paginated gallery of every photo in an event.
Image Details
One photo and its curated metadata by image ID.
Photo Timeline
Browse photos by capture time with day/hour buckets.
Search
BIB Search
Find photos by participant BIB number with 9Pic BibTrack.
Face Search
Find photos by uploading a selfie with 9Pic FaceFind.
Video
Video Clipping Search
Generate personalised video clips with 9Pic Motion (async).
Downloads
Download Originals
Presigned URLs for original (unwatermarked) photos using a BIB number, selfie
request_id, or image IDs.Pipeline
Pipeline Status
Poll import, processing, and go-live stage status for photos.
Import Photos
Import photos from configured sources.
Process Photos
Run AI processing (watermark, BIB, face indexing).
Go Live
Publish processed photos to the public gallery.
Models
API Models
Shared request and response models for events, photos, search, downloads, and pagination.

