---
title: "Lists"
description: "Get one page of a list, or every item in it."
url: "https://docs.goomzo.africa/docs/developers/ts-sdk/lists"
docs_index: /llms.txt
lastUpdated: 2026-11-12
section: "Reference"
related:
  - /docs/developers/ts-sdk/errors
  - /docs/developers/ts-sdk/resources
---

> For an index of all documentation, see [/llms.txt](https://docs.goomzo.africa/llms.txt). Any page is also available as Markdown by adding .md to its URL.

# Lists

> Get one page of a list, or every item in it.

A list method answers with a `PageList`. Await it for one page, or loop over it with `for await` for every item: it
asks for the next page as you go.

## One page

```ts
const page = await goomzo.customers.list({ limit: 50 })

page.items // up to 50 customers
page.nextCursor // send as cursor for the next page, or null on the last
page.total // how many match, on every page
```

## Every item

```ts
for await (const customer of goomzo.customers.list({ limit: 200 })) {
  await syncCustomer(customer)
}
```

**Note:** `limit` sets the size of each page, up to 200. A larger page means fewer requests.

## Next steps

- [Errors](https://docs.goomzo.africa/docs/developers/ts-sdk/errors?utm_source=llms&utm_medium=ai)
- [Resources](https://docs.goomzo.africa/docs/developers/ts-sdk/resources?utm_source=llms&utm_medium=ai)

---

For an index of all available documentation, see [/llms.txt](https://docs.goomzo.africa/llms.txt)