---
title: pydo.toolbelts.list()
description: List Toolbelts
product: Reference
url: https://docs.digitalocean.com/reference/pydo/reference/toolbelts/list/
last_updated: "2026-10-16"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# pydo.toolbelts.list()

Generated on 16 Oct 2026 from `pydo` version [`v0.44.0`](https://github.com/digitalocean/pydo/releases/tag/v0.44.0v0.44.0)

## Usage

```python
client.toolbelts.list(
    status="active",
    page=1,
    per_page=20,
)
```

Returns `JSON` Raises `HttpResponseError`

## Description

Returns your team’s toolbelts, one entry per name describing its latest version, sorted by name. Offset-paged with page and `per_page`; pagination reports the total.

## Parameters

`status` string optional

active (default), deprecated, or all. Case-insensitive.

One of: `active`, `deprecated`, `all`

Default: `active`

`page` integer optional

1-based page number. Values below 1 are treated as 1.

Min: `1`

Default: `1`

`per_page` integer optional

Page size. Defaults to 20; values above 100 are capped at 100.

Min: `1`

Max: `100`

Default: `20`

## Pagination

This method returns paginated results. The response includes a `links.pages` object with URLs for navigating between pages. To retrieve the next page, parse the `next` URL and pass the `page` parameter:

```python
from urllib.parse import urlparse, parse_qs

resp = client.toolbelts.list()
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.toolbelts.list(page=page)
    pages = resp.get("links", {}).get("pages", {})
```

## Response Example

## Show Response Example

```json
{
  "toolbelts": [
    {
      "name": "search-toolbelt",
      "display_name": "Search Tools",
      "latest_version": "1",
      "version_count": 1,
      "tool_count": 2,
      "status": "active",
      "reference_latest": "search-toolbelt",
      "updated_at": "2026-06-11T12:00:00Z",
      "description": "Tools for searching and fetching public web pages."
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1
  }
}
```

## More Information

See [`/v2/action-gateway/toolbelts`](https://docs.digitalocean.com/reference/api/reference/action-gateway/index.html.md#toolbelts_list) in the API reference for additional detail on responses, headers, parameters, and more.