Skip to main content

​
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 page for a deeper explanation; the short version is below. 
{
  "responseType": "success",
  "message": "Records for all images",
  "data": {
    "images": [],
    "pagination": {
      "total": 0,
      "currentPage": 0,
      "totalPages": 0,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "page_size": 32
    }
  }
}

​
Common Models

Pagination

Metadata returned with paginated lists.

​
Events

Event Models

EventListItem, EventListResponse, and EventDetailsResponse.

Image Model

Shared photo object returned by gallery and search endpoints.

Search Responses

Response envelopes for all photos, BIB search, face search, and video clipping search.

​
Downloads

Download Models

Request and response models for original photo downloads.