Pagination

Reservation Summaries API - Effective April 17, 2025

Starting April 17th, 2025, the Reservation Summaries API will implement default pagination behavior for requests where the limit and offset parameters are omitted.

• Default pagination limit: If the limit parameter is not specified, the API will default to 100 reservation summaries per request.
• Default pagination offset: If the offset parameter is not specified, the API will default to 0, ensuring that the results start from the beginning.

For example, a request to retrieve all reservation summaries with an arrival date in April 2025 would look like this:

curl --location 'https://app.recranet.com/api/reservations/summaries?organization=1450&dateFrom=2025-04-01&dateTo=2025-04-30&referenceDate=date-from&limit=100&offset=0' \
--header 'Accept: application/json'

When a response is paginated, the response headers will include a Link header with next/last urls.

Link: </api/reservations/summaries?organization=1450&dateFrom=2024-01-01&dateTo=2024-12-31&referenceDate=date-from&limit=100&offset=100>; rel="next",</api/reservations/summaries?organization=1450&dateFrom=2024-01-01&dateTo=2024-12-31&referenceDate=date-from&limit=100&offset=1100>; rel="last"

X-Pagination-Next: 100
X-Pagination-Last: 1100

If the response is paginated and the offset is for example 100 the Link header will contain next/last/prev/first:

Link: </api/reservations/summaries?organization=1450&dateFrom=2025-04-01&dateTo=2025-04-30&referenceDate=date-from&limit=100&offset=200>; rel="next",</api/reservations/summaries?organization=1450&dateFrom=2025-04-01&dateTo=2025-04-30&referenceDate=date-from&limit=100&offset=1100>; rel="last",</api/reservations/summaries?organization=1450&dateFrom=2025-04-01&dateTo=2025-04-30&referenceDate=date-from&limit=100&offset=0>; rel="prev",</api/reservations/summaries?organization=1450&dateFrom=2025-04-01&dateTo=2025-04-30&referenceDate=date-from&limit=100&offset=0>; rel="first"

X-Pagination-Next: 200
X-Pagination-Last: 1100
X-Pagination-Prev: 0
X-Pagination-First: 0

If the endpoint does not support pagination, or if all results fit on a single page, the Link header will be omitted.

curl --location 'https://app.recranet.com/api/reservations/summaries?organization=1450&dateFrom=2025-04-01&dateTo=2025-04-02&referenceDate=date-from&limit=100&offset=0' \
--header 'Accept: application/json

If the request query parameters limit and offset are omitted before April 17th, 2025, pagination will not be implemented, and the Link header will not be returned. To enable pagination, include the default limit=100 and offset=0 query parameters in the request.

Date range for Reservation Summaries API

Before: You could only request data for a period of up to 31 days. After: You can now request data for a period of up to 1 year, using query params dateFrom, dateTo and limit=100.

For example, a request for reservations from 2025-04-01 to 2026-04-01 is now supported.

Please refer to the updated API documentation for more details on the new date range limits and pagination.