Skip to main content
Most list endpoints support offset pagination.

Offset pagination

  • Params: page (default 1) and limit (default 20, max 100)
  • Responses include total when available and may include next/prev links
Example:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \
  "https://api.boseat.com/v1/bookings?page=2&limit=50"

Best practices

  • Prefer smaller limit values for latency-sensitive clients.
  • Use pagination parameters consistently to avoid large responses.
  • Stop when no results are returned or total indicates completion.
Defaults and ordering:
  • Default limit is 20; maximum is 100 unless otherwise noted.
  • Ordering follows the resource’s default (often createdAt desc); use filters where available.