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)