# Pagination (/docs/api/pagination)



Every list endpoint answers the same shape:

```json
{
    "data": [ { "id": "…" } ],
    "nextCursor": "eyJ2IjoiMjAyNi0xMS0wNFQxMDowMDowMC4wMDBaIiwiaWQiOiIwMTk1…"
}
```

`nextCursor` is `null` on the last page. To get the next page, send it back as `cursor`, with the same filters:

```bash title="cURL"
curl "https://feedhorizon.com/api/v1/posts?limit=50&cursor=eyJ2IjoiMjAyNi0x…" \
  -H "Authorization: Bearer fh_YOUR_API_KEY"
```

* `limit` is 1 to 100, default 20.
* Cursors are opaque. Do not build or change them; a changed cursor is refused with `invalid_cursor`.
* Pages stay stable while posts are added or removed, unlike page numbers.
* Small lists (profiles, accounts, webhooks, API keys, invites) return everything at once with `nextCursor: null`.

```javascript title="Node.js"
async function* allPosts(apiKey) {
    let cursor = null;
    do {
        const url = new URL('https://feedhorizon.com/api/v1/posts');
        url.searchParams.set('limit', '100');
        if (cursor) url.searchParams.set('cursor', cursor);
        const res = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
        const page = await res.json();
        yield* page.data;
        cursor = page.nextCursor;
    } while (cursor);
}
```