List Events

Overview

Returns a paginated list of every event belonging to your organisation. Use this to discover event_id values for the photo, search, and download endpoints.

Endpoint

GET /api/v1/ext/{org_id}/events

Path Parameters

Parameter	Type	Required	Description
`org_id`	number	Yes	Your organisation ID.

Query Parameters

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

This endpoint returns paginated results. See the Pagination Model for the metadata shape and Conventions for shared rules.

Example Request

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

import requests

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

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

Example Response

{
  "responseType": "success",
  "message": "Records for events",
  "data": {
    "events": [
      {
        "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"
      },
      {
        "event_id": 789,
        "event_name": "Delhi Half Marathon",
        "event_slug": "delhi-half-marathon",
        "event_date": "2026-03-15T05:30:00",
        "status": "draft",
        "cover_image": null
      }
    ],
    "pagination": {
      "total": 24,
      "currentPage": 1,
      "totalPages": 3,
      "hasNextPage": true,
      "hasPreviousPage": false,
      "page_size": 10
    }
  }
}

Response Models

Model	Description
EventListResponse	Top-level response containing `events` and `pagination`.
EventListItem	Event object returned inside `events[]`.
PaginationInfo	Pagination metadata.

Error Responses

Status	Meaning
`401`	API key is missing.
`403`	API key is invalid, inactive, or does not belong to this organisation.
`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