> ## Documentation Index
> Fetch the complete documentation index at: https://docs.9pic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Details

> Get event metadata and enabled search capabilities for a single event

## 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

<CodeGroup>
  ```bash cURL theme={null}
  curl -i \
    -H "X-API-Key: <your_9pic_api_key>" \
    "https://api.9pic.ai/api/v1/ext/903/event/456/details"
  ```

  ```python Python theme={null}
  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())
  ```

  ```javascript JavaScript theme={null}
  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());
  ```
</CodeGroup>

## Example Response

```json theme={null}
{
  "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                              |
| ----------------------------------------------------------------------------------- | ---------------------------------------- |
| <a href="/api-reference/models/event#eventdetailsresponse">EventDetailsResponse</a> | Event metadata and search-feature flags. |

<Tip>
  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](/api-reference/photo-timeline) endpoints (`GET /timeline/days` and `GET /timeline/images`).
</Tip>

## 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](/api-reference/errors) for canonical descriptions and retry guidance.