---
title: "Lists"
description: "Get one page of a list, or every item in it."
url: "https://docs.goomzo.africa/docs/developers/python-sdk/lists"
docs_index: /llms.txt
lastUpdated: 2026-11-12
section: "Reference"
related:
  - /docs/developers/python-sdk/errors
  - /docs/developers/python-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 returns a `Page`. Read its `items` for one page, or loop over it for every item: it asks for the next
page as you go.

## One page

```python
page = goomzo.customers.list(limit=50)

page.items  # up to 50 customers
page.next_cursor  # None on the last page
page.total  # how many match, on every page
```

## Every item

```python
for customer in goomzo.customers.list(limit=200):
    sync_customer(customer)
```

With asyncio, await a list for one page, or `async for` over it for every item:

```python
page = await goomzo.customers.list(limit=50)

async for customer in goomzo.customers.list(limit=200):
    await sync_customer(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/python-sdk/errors?utm_source=llms&utm_medium=ai)
- [Resources](https://docs.goomzo.africa/docs/developers/python-sdk/resources?utm_source=llms&utm_medium=ai)

---

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