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

> Event list and event detail response models

## Overview

This page documents the three event-related response models: a single event row (`EventListItem`), the paginated event list response (`EventListResponse`), and the per-event details response (`EventDetailsResponse`).

## EventListItem

`EventListItem` is returned inside the `events` array from [List Events](/api-reference/list-events).

```json theme={null}
{
  "event_id": 456,
  "event_name": "Mumbai Marathon 2026",
  "event_slug": "mumbai-marathon-2026",
  "event_date": "2026-01-19T06:00:00",
  "status": "active",
  "cover_image": "https://photos.9pic.ai/imgs/456/cover.jpg"
}
```

| 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 as an ISO 8601 datetime string. |
| `status`      | string \| null | Current event status.                      |
| `cover_image` | string \| null | Cover image URL or path for the event.     |

## EventListResponse

Top-level response returned by [List Events](/api-reference/list-events). It uses the standard envelope from [Conventions](/api-reference/conventions#response-envelope); the typed payload lives in `data`.

```json theme={null}
{
  "responseType": "success",
  "message": "Records for events",
  "data": {
    "events": [],
    "pagination": {
      "total": 0,
      "currentPage": 0,
      "totalPages": 0,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "page_size": 10
    }
  }
}
```

| Field             | Type   | Description                                                             |
| ----------------- | ------ | ----------------------------------------------------------------------- |
| `data.events`     | array  | Paginated list of <a href="#eventlistitem">EventListItem</a> objects.   |
| `data.pagination` | object | <a href="/api-reference/models/pagination">PaginationInfo</a> metadata. |

## EventDetailsResponse

`EventDetailsResponse` is returned by [Event Details](/api-reference/event-details). The event metadata lives inside `data`.

```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
  }
}
```

| Field                      | Type           | Description                                                                                                                       |
| -------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `data.event_id`            | number         | Unique event identifier.                                                                                                          |
| `data.event_name`          | string \| null | Display name of the event.                                                                                                        |
| `data.event_slug`          | string \| null | URL-friendly slug.                                                                                                                |
| `data.event_date`          | string \| null | Event date as an ISO 8601 datetime string.                                                                                        |
| `data.status`              | string \| null | Current event status.                                                                                                             |
| `data.event_enabled`       | boolean        | Whether the event is enabled for client/external use.                                                                             |
| `data.bib_search`          | boolean        | Whether **9Pic BibTrack** ([BIB Search](/api-reference/bib-search)) is enabled.                                                   |
| `data.selfie_search`       | boolean        | Whether **9Pic FaceFind** ([Face Search](/api-reference/face-search)) is enabled.                                                 |
| `data.name_search`         | boolean        | Whether name-based search is enabled.                                                                                             |
| `data.video_search`        | boolean        | Whether **9Pic Motion** ([Video Clipping Search](/api-reference/video-clipping-search)) is enabled at the event level.            |
| `data.video_selfie_search` | boolean        | Whether selfie-driven 9Pic Motion video clipping is enabled. Always `false` when `video_search` is `false`.                       |
| `data.timeline_search`     | boolean        | Whether the [Photo Timeline](/api-reference/photo-timeline) endpoints (`GET /timeline/days`, `GET /timeline/images`) are enabled. |

## Used By

<CardGroup cols={2}>
  <Card title="List Events" icon="list" href="/api-reference/list-events">
    Returns `EventListResponse` containing `EventListItem[]` and `PaginationInfo`.
  </Card>

  <Card title="Event Details" icon="circle-info" href="/api-reference/event-details">
    Returns `EventDetailsResponse`.
  </Card>
</CardGroup>