Skip to main content

Pagination

List endpoints that can grow — events, players, and blog posts — accept limit and offset query parameters:

ParamMeaning
limitMax items to return. Omit to use the server default.
offsetNumber of items to skip (for the next page).

Each paginated response also includes a total count so you can render page controls without fetching everything:

  • Events → count (and oldestYear for a year filter)
  • Blog posts → total
  • Players → count

Example

# First 20 events
curl "https://api.front9.io/api/public/v1/orgs/{orgSlug}/events?limit=20&offset=0"

# Next 20
curl "https://api.front9.io/api/public/v1/orgs/{orgSlug}/events?limit=20&offset=20"
{
"count": 57,
"events": [ /* up to 20 items */ ]
}

Page through by advancing offset by limit until offset >= count.

Filtering events

The events list also supports:

  • filter=upcoming or filter=completed
  • year=2026 to scope to a calendar year (use the response's oldestYear to build a year picker)

These combine with limit/offset.

Endpoints that return small, bounded sets — membership plans, standings tables, a single event's tee sheets or leaderboard — are not paginated; they return the full result.