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

https://api.9pic.ai
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.
curl -i \
  -H "X-API-Key: <your_9pic_api_key>" \
  "https://api.9pic.ai/api/v1/ext/903/event/456/ping"
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

Photos and videos are grouped under the Memories section of the API.

All Photos

Paginated gallery of every photo in an event.

BIB Search

Find photos by participant BIB number with 9Pic BibTrack.

Face Search

Find photos by uploading a selfie with 9Pic FaceFind.

Video Clipping Search

Generate personalised video clips with 9Pic Motion (async).

Download Originals

Presigned URLs for original (unwatermarked) photos using a BIB number or a selfie request_id.

​
Models

API Models

Shared request and response models for events, photos, search, downloads, and pagination.