---
title: "Lists"
description: "Get one page of a list, or every item in it."
url: "https://docs.goomzo.africa/docs/developers/go-sdk/lists"
docs_index: /llms.txt
lastUpdated: 2026-11-12
section: "Reference"
related:
  - /docs/developers/go-sdk/errors
  - /docs/developers/go-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 is an iterator. Range over it for every item: it asks for the next page as you go, and stops at the first
error.

## Every item

```go
for customer, err := range client.Customers.List(ctx, goomzo.CustomerListParams{Limit: 200}) {
	if err != nil {
		return err
	}
	syncCustomer(customer)
}
```

## One page

```go
page, err := client.Customers.ListPage(ctx, goomzo.CustomerListParams{Limit: 50})

page.Items      // up to 50 customers
page.NextCursor // "" on the last page; send it as Cursor for the next
page.Total      // how many match, on every page
```

**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/go-sdk/errors?utm_source=llms&utm_medium=ai)
- [Resources](https://docs.goomzo.africa/docs/developers/go-sdk/resources?utm_source=llms&utm_medium=ai)

---

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