Skip to main content

​
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

ParameterTypeRequiredDescription
org_idnumberYesYour organisation ID.
event_idnumberYesThe 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"

​
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

ModelDescription
EventDetailsResponseEvent 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

StatusMeaning
401API key is missing.
403API key is invalid, inactive, or token/event ownership mismatch.
404Event configuration not found.
429Rate limit exceeded. Back off and retry.
500Internal failure.
See Errors for canonical descriptions and retry guidance.