Overview
Returns the minimum event metadata for a single event, including the event name, slug, and which search features (BIB, selfie, name) are enabled. Use this to check capabilities before calling search endpoints.
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"
Example Response
{
"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
}
Response Fields
| Field | Type | Description |
|---|
event_id | number | Unique event identifier |
event_name | string | null | Display name of the event |
event_slug | string | null | URL-friendly slug |
event_date | string | null | Event date in ISO 8601 format |
status | string | null | Current event status |
event_enabled | boolean | Whether the event is live for external/client use |
bib_search | boolean | Whether BIB number search is enabled |
selfie_search | boolean | Whether selfie/face search is enabled |
name_search | boolean | Whether name-based search is enabled |
Check the bib_search, selfie_search, and name_search flags before calling the corresponding search endpoints. If a search type is disabled, the search endpoint will return 403.
Error Responses
| Status | Meaning |
|---|
401 | API key is missing |
403 | API key is invalid, inactive, token does not belong to this organisation, or event does not belong to this organisation |
404 | Event configuration not found |
