> ## Documentation Index
> Fetch the complete documentation index at: https://help.skillsdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> limit / offset with strict bounds

<Info>
  **Quick Summary:** Collections take `limit` (default 50, max 200) and `offset` (max 10,000). Out-of-range values are **rejected with a 400**, never silently clamped.
</Info>

```bash theme={null}
curl "https://prod.skillsdbnext.com/api/v1/careers?limit=50&offset=100" \
  -H "Authorization: Bearer sdb_live_YOUR_KEY_HERE"
```

Every collection response carries the paging state back to you:

```json theme={null}
{ "data": ["..."], "meta": { "total": 342, "limit": 50, "offset": 100 } }
```

Iterate until `offset + limit >= total`. If you find yourself paging past the 10,000-offset cap, narrow the result set with [filters](/api-docs/rest/filtering) instead — deep offset pagination is slow for everyone.

Sub-resource lists that are naturally complete (a career's levels, sections, skills) return the full set in one response with `meta.total` equal to the length.