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
Participant App guide
Start here if you are building a photo search app: our recommended frontend and backend setup, and why your backend should save each search ID.
Authentication
API keys, plus OAuth access tokens for AI assistants.
Conventions
Base URL, identifiers, response envelopes, and pagination.
Errors
Status codes, common causes, and retry guidance.
Ping
Verify your integration end to end.
Account
The signed-in account and its organisations (OAuth only).
Coding Agents
Install Agent Skills so Cursor, Claude Code, Codex, and similar tools follow these pages when they write an integration:9pic-integration skill. It keeps the API key on your backend, checks Event Details before search, reuses one search identifier, and shows previews in the gallery.
Participant App
The guideline for building a client interface on the 9Pic API.
Sell Originals
Your checkout, then original photos after a confirmed sale.
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 by selfie, bib number or video name 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.
Unpublish
Move a live gallery back to draft (OAuth only).
Webhooks
Purchase Webhook
Payload 9Pic POSTs to your endpoint on every completed 9Pic Checkout purchase, with the tax and discount breakdown needed to raise an invoice.
Models
API Models
Shared request and response models for events, photos, search, downloads, and pagination.

