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

# API Models

> Shared request and response models used by the 9Pic API

## Overview

Model pages document the exact JSON shapes returned by 9Pic endpoints. Each page lists the model's fields, types, nullability, and the endpoints it appears in.

The API returns one of two response envelopes. Read the [Conventions](/api-reference/conventions#response-envelopes) page for a deeper explanation; the short version is below.

<CodeGroup>
  ```json Photo / search envelope theme={null}
  {
    "responseType": "success",
    "message": "Records for all images",
    "data": {
      "images": [],
      "pagination": {
        "total": 0,
        "currentPage": 0,
        "totalPages": 0,
        "hasNextPage": false,
        "hasPreviousPage": false,
        "page_size": 32
      }
    }
  }
  ```

  ```json Flat object envelope theme={null}
  {
    "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
  }
  ```
</CodeGroup>

## Common Models

<CardGroup cols={2}>
  <Card title="Pagination" icon="list" href="/api-reference/models/pagination">
    Metadata returned with paginated lists.
  </Card>
</CardGroup>

## Events

<CardGroup cols={2}>
  <Card title="Event Models" icon="calendar" href="/api-reference/models/event">
    `EventListItem`, `EventListResponse`, and `EventDetailsResponse`.
  </Card>
</CardGroup>

## Photos and Search

<CardGroup cols={2}>
  <Card title="Image Model" icon="image" href="/api-reference/models/image">
    Shared photo object returned by gallery and search endpoints.
  </Card>

  <Card title="Search Responses" icon="magnifying-glass" href="/api-reference/models/search-responses">
    Response envelopes for all photos, BIB search, face search, and video clipping search.
  </Card>
</CardGroup>

## Downloads

<CardGroup cols={2}>
  <Card title="Download Models" icon="cloud-arrow-down" href="/api-reference/models/downloads">
    Request and response models for original photo downloads.
  </Card>
</CardGroup>