Event Details

Overview

Returns the minimum metadata for a single event — its name, slug, date, status, and the boolean flags for which search features (BIB, selfie, name, video, photo timeline) are enabled. Call this before invoking any search endpoint to avoid a 403 for a disabled feature.

Endpoint

GET /api/v1/ext/{org_id}/event/{event_id}/details

Path Parameters

Parameter	Type	Required	Description
`org_id`	number	Yes	Your organisation ID.
`event_id`	number	Yes	The event to retrieve.

Example Request

curl -i \
  -H "X-API-Key: <your_9pic_api_key>" \
  "https://api.9pic.ai/api/v1/ext/903/event/456/details"

import requests

response = requests.get(
    "https://api.9pic.ai/api/v1/ext/903/event/456/details",
    headers={"X-API-Key": "<your_9pic_api_key>"},
)
print(response.status_code, response.json())

const response = await fetch(
  "https://api.9pic.ai/api/v1/ext/903/event/456/details",
  { headers: { "X-API-Key": "<your_9pic_api_key>" } }
);
console.log(await response.json());

Example Response

{
  "responseType": "success",
  "message": "Event details",
  "data": {
    "event_id": 456,
    "event_name": "Mumbai Marathon 2026",
    "event_slug": "mumbai-marathon-2026",
    "event_date": "2026-01-19T06:00:00",
    "status": "active",
    "event_enabled": true,
    "bib_search": true,
    "selfie_search": true,
    "name_search": false,
    "video_search": true,
    "video_selfie_search": true,
    "timeline_search": true
  }
}

Response Models

Model	Description
EventDetailsResponse	Event metadata and search-feature flags.

Check bib_search, selfie_search, name_search, video_search, video_selfie_search, and timeline_search before calling the corresponding search endpoints. Calling a search endpoint when its flag is false returns 403. video_selfie_search is only true when the event-level video_search toggle is on and selfie-driven video clipping has been enabled by the organiser. timeline_search gates both Photo Timeline endpoints (GET /timeline/days and GET /timeline/images).

Error Responses

Status	Meaning
`401`	API key is missing.
`403`	API key is invalid, inactive, or token/event ownership mismatch.
`404`	Event configuration not found.
`429`	Rate limit exceeded. Back off and retry.
`500`	Internal failure.

See Errors for canonical descriptions and retry guidance.

Get Started

Events

Memories

Browse Photos

Search

Video

Downloads

Pipeline

Models

Overview

Endpoint

Path Parameters

Example Request

Example Response

Response Models

Error Responses

​Overview

​Endpoint

​Path Parameters

​Example Request

​Example Response

​Response Models

​Error Responses

Overview

Endpoint

Path Parameters

Example Request

Example Response

Response Models

Error Responses