Skip to main content
The 9Pic API is the developer surface over 9Pic AI’s event memory products. With a single 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

All endpoints are versioned under /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:
Building a participant-facing interface (find-my-photos, selfie or BIB search, gallery, clips)? Start with the participant app section of the 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.

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.