Skip to main content

​
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

ParameterTypeRequiredDescription
org_idnumberYesYour organisation ID.

​
Query Parameters

ParameterTypeRequiredDescription
pagenumberNoPage number (default: 1).
page_sizenumberNoItems 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"

​
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

ModelDescription
EventListResponseTop-level response containing events and pagination.
EventListItemEvent object returned inside events[].
PaginationInfoPagination metadata.

​
Error Responses

StatusMeaning
401API key is missing.
403API key is invalid, inactive, or does not belong to this organisation.
429Rate limit exceeded. Back off and retry.
500Internal failure.
See Errors for canonical descriptions and retry guidance.