Guides
Pagination
How to navigate through large lists of events.
To ensure performance and usability, the GlobalEventBase API paginates responses. You can control the pagination using the page and size query parameters.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | Integer | 1 | The page number to retrieve. Must be >= 1. |
size | Integer | 20 | The number of items per page. Max 100. |
Request Structure
GET /api/events?page={page}&size={size}Response Structure
The API response includes pagination metadata to help you navigate the results:
{
"page": 2,
"size": 20,
"total": 150,
"items": [ ... ]
}page: The current page number.size: The number of items per page.total: The total number of items matching your criteria.
Example
To fetch the second page of results with 50 items per page:
curl "https://globaleventbase.com/api/events?page=2&size=50"Best Practices
- Limit Page Size: Avoid requesting the maximum size (
100) unless necessary to reduce latency. - Handle Empty Pages: If you request a page that exceeds the total number of pages, the
itemsarray will be empty.