All Photos

Overview

Returns the complete set of photos for an event as paginated image objects (large URL, thumbnail URL, image ID, width, height, and curated metadata). Use this to render an event’s gallery without filtering by BIB or selfie. Photos are ordered by capture timestamp ascending; photos with no timestamp are returned last. The order is stable across pages.

This endpoint always returns every photo mapped to the event. It does not honour internal visibility flags such as show_all_images or custom_show_images.

Endpoint

GET /api/v1/ext/{org_id}/event/{event_id}/images

Path Parameters

Parameter	Type	Required	Description
`org_id`	number	Yes	Your organisation ID.
`event_id`	number	Yes	The event whose photos you want to list.

Query Parameters

Parameter	Type	Required	Description
`page`	number	No	Page number (default: `1`).
`page_size`	number	No	Images per page (default: `32`, max: `100`).

This endpoint returns paginated results. See the Pagination Model.

Example Request

curl -i \
  -H "X-API-Key: <your_9pic_api_key>" \
  "https://api.9pic.ai/api/v1/ext/903/event/456/images?page=1&page_size=32"

import requests

response = requests.get(
    "https://api.9pic.ai/api/v1/ext/903/event/456/images",
    headers={"X-API-Key": "<your_9pic_api_key>"},
    params={"page": 1, "page_size": 32},
)
print(response.status_code, response.json())

const response = await fetch(
  "https://api.9pic.ai/api/v1/ext/903/event/456/images?page=1&page_size=32",
  { headers: { "X-API-Key": "<your_9pic_api_key>" } }
);
console.log(await response.json());

Example Response

Images Found
Empty Event

{
  "responseType": "success",
  "message": "Records for all images",
  "data": {
    "images": [
      {
        "img_url": "https://photos.9pic.ai/imgs/456/large/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
        "height": 4860,
        "width": 3240,
        "image_id": "a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244",
        "thumbnail_url": "https://photos.9pic.ai/imgs/456/small/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
        "original_url": null,
        "meta_info": {
          "photo_timestamp": 1700000000,
          "photographer_name": "photographer-a",
          "original_file_name": "IMG_0001.JPG",
          "source": "9Pic storage",
          "image_path": "456/photographer-a/originals/IMG_0001.JPG"
        }
      },
      {
        "img_url": "https://photos.9pic.ai/imgs/456/large/b5513429-1d05-5f2f-c9f9-bd9f9g3gd355.jpg",
        "height": 4860,
        "width": 3240,
        "image_id": "b5513429-1d05-5f2f-c9f9-bd9f9g3gd355",
        "thumbnail_url": "https://photos.9pic.ai/imgs/456/small/b5513429-1d05-5f2f-c9f9-bd9f9g3gd355.jpg",
        "original_url": null,
        "meta_info": {
          "photo_timestamp": 1700000100,
          "photographer_name": null,
          "original_file_name": "drive_original.jpg",
          "source": "Google Drive",
          "image_path": "drive-file-id-123",
          "google_drive_link": "https://drive.google.com/file/d/drive-file-id-123/view"
        }
      }
    ],
    "pagination": {
      "total": 1280,
      "currentPage": 1,
      "totalPages": 40,
      "hasNextPage": true,
      "hasPreviousPage": false,
      "page_size": 32
    }
  }
}

{
  "responseType": "success",
  "message": "No images found",
  "data": {
    "images": [],
    "pagination": {
      "total": 0,
      "currentPage": 0,
      "totalPages": 0,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "page_size": 32
    }
  }
}

Response Models

Model	Description
AllPhotosResponse	Top-level all-photos response envelope.
ImageItemWithMeta	Image object returned inside `data.images[]`.
PaginationInfo	Pagination metadata returned inside `data.pagination`.

original_url is null in this response. meta_info is a curated object from the mapped photo row and the matching image-processing record. It includes the photo timestamp, original filename, public source label, image path, Google Drive link when the source is Google Drive, and photographer folder name when available from the 9Pic upload path.

Use Download Original Photos with method: "bib" or method: "selfie" to fetch presigned download links for originals.

Error Responses

Status	Meaning
`401`	API key is missing.
`403`	API key is invalid, inactive, or token/event ownership mismatch.
`404`	Event not found.
`429`	Rate limit exceeded. Back off and retry.
`500`	Internal failure.

See Errors for canonical descriptions and retry guidance.

Get Started

Events

Memories

Browse Photos

Search

Video

Downloads

Pipeline

Models

Overview

Endpoint

Path Parameters

Query Parameters

Example Request

Example Response

Response Models

Error Responses

​Overview

​Endpoint

​Path Parameters

​Query Parameters

​Example Request

​Example Response

​Response Models

​Error Responses

Overview

Endpoint

Path Parameters

Query Parameters

Example Request

Example Response

Response Models

Error Responses