---
title: "Lists"
description: "Get one page of a list, or every item in it."
url: "https://docs.goomzo.africa/docs/developers/php-sdk/lists"
docs_index: /llms.txt
lastUpdated: 2026-11-12
section: "Reference"
related:
  - /docs/developers/php-sdk/errors
  - /docs/developers/php-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

```php
$page = $goomzo->customers->list(['limit' => 50]);

$page->items; // up to 50 customers
$page->nextCursor; // null on the last page
$page->total; // how many match, on every page
```

## Every item

```php
foreach ($goomzo->customers->list(['limit' => 200]) as $customer) {
    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/php-sdk/errors?utm_source=llms&utm_medium=ai)
- [Resources](https://docs.goomzo.africa/docs/developers/php-sdk/resources?utm_source=llms&utm_medium=ai)

---

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