Pagination

List endpoints return paginated results to improve performance and reduce response size.

Pagination Parameters

Parameter Type Description

page

integer

Page number (zero-based). Default: 0

size

integer

Number of items per page. Default: 20, Max: 100

sort

string

Sort field and direction, e.g., "name,asc" or "createdDate,desc"

Example Request

curl -X GET "https://api.seatmap.pro/api/private/v2.0/events?page=0&size=20&sort=name,asc" \
  -H "X-API-Key: your-api-key"

Response Structure

Paginated responses include metadata about the result set:

{
  "content": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Summer Concert 2026"
    }
  ],
  "pageable": {
    "pageNumber": 0,
    "pageSize": 20,
    "sort": {
      "sorted": true,
      "unsorted": false
    }
  },
  "totalElements": 150,
  "totalPages": 8,
  "last": false,
  "first": true,
  "number": 0,
  "size": 20
}

Navigating Pages

  • first: true if this is the first page

  • last: true if this is the last page

  • totalPages: total number of pages available

  • totalElements: total number of items across all pages

  • number: current page number (zero-based)