Skip to main content

Overview

Returns a paginated list of all events belonging to your organisation. Use this to discover event_id values for other API calls.

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 guide for details.

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

{
  "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 Fields

Event Object

FieldTypeDescription
event_idnumberUnique event identifier
event_namestring | nullDisplay name of the event
event_slugstring | nullURL-friendly slug
event_datestring | nullEvent date in ISO 8601 format
statusstring | nullCurrent event status (e.g. active, draft)
cover_imagestring | nullCover image URL or path

Error Responses

StatusMeaning
401API key is missing
403API key is invalid, inactive, or does not belong to this organisation