Skip to main content
Menu

Reference

Pagination, filtering & sorting

Consistent conventions across every list endpoint.

Pagination

List endpoints use limit (1–100, default 25) and offset (default 0). The meta.pagination block tells you the total and whether more remain.

bash
curl "https://api.anglerpass.com/v1/properties?limit=50&offset=50"
meta
"meta": {
  "request_id": "req_9f2c1a7b3e4d5c6f",
  "pagination": { "limit": 50, "offset": 50, "total": 214, "has_more": true }
}

Filtering

Each endpoint documents its own filters (e.g. properties accept state, water_type, species, bounds, and a full-text q). Multi-value filters are comma-separated: ?techniques=dry+fly,nymphing.

Sorting

v1 endpoints return a sensible default order (guides rank Pro-tier first then by rating; properties and clubs sort by name). Configurable sort is on the roadmap alongside cursor pagination — both will be additive and won't change existing defaults.