Skip to main content
List endpoints return a limited set of records.

​
API v2

API v2 list endpoints use cursor pagination. Send these query parameters:
ParameterDefaultMaximumDescription
limit25100Number of records to return.
cursor--Opaque cursor from the previous page’s nextCursor.
Responses include pagination metadata: 
{
  "data": [],
  "pagination": {
    "limit": 25,
    "nextCursor": "eyJzb3J0IjoiY3JlYXRlZEF0OmRlc2MiLCJsYXN0SWQiOiI2NmYxNjE5MWY3Mzk3MDVmYWEwMjA3NjgiLCJsYXN0U29ydFZhbHVlIjoiMjAyNi0wMS0wMlQwMDowMDowMC4wMDBaIn0",
    "hasMore": true,
    "total": 42
  }
}
  • limit echoes the page size that was applied.
  • nextCursor is an opaque token. Pass it back as cursor to fetch the next page. Do not parse or build it yourself. It is null when there are no more records.
  • hasMore is true when another page is available.
  • total is the number of matching records across all pages.
To page through results, repeat the request with cursor set to the previous response’s nextCursor until hasMore is false.

​
API v1

API v1 uses offset pagination.
ParameterDefaultMaximumDescription
max10100Number of records to return.
offset0-Number of records to skip.
curl \
  -H "Authorization: Bearer <API_KEY>" \
  "https://spaportal.cz/api/v1/hotels?max=10&offset=20"
Read the X-Total-Count response header to get the total number of matching records. Some nested list responses also support max_nested. Its default is 10 and maximum is 100.