---
title: List extensions
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/python)

[Registrar Sandbox](https://developers.cloudflare.com/api/python/resources/registrar%5Fsandbox)

[Extensions](https://developers.cloudflare.com/api/python/resources/registrar%5Fsandbox/subresources/extensions)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# List extensions

registrar\_sandbox.extensions.list(ExtensionListParams\*\*kwargs)  \-> SyncCursorPagination\[[ExtensionListResponse](https://developers.cloudflare.com/api/python/resources/registrar%5Fsandbox#%28resource%29%20registrar%5Fsandbox.extensions%20%3E%20%28model%29%20extension%5Flist%5Fresponse%20%3E%20%28schema%29)\]

GET/accounts/{account\_id}/registrar-sandbox/extensions

Returns metadata and JSON Schema documents describing the expected input structure for registration operations on each supported extension (TLD).

This endpoint uses cursor-based pagination. Results are ordered by extension name by default. To fetch the next page, pass the `cursor`value from the `result_info` object in the response as the `cursor`query parameter in your next request. An empty `cursor` string indicates there are no more pages.

Supports HTTP conditional GET via `ETag`. Include the `ETag` value from a previous response in an `If-None-Match` header to receive a `304 Not Modified` when the data has not changed.

##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/).

**Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY`

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

**Example:**`X-Auth-Email: user@example.com`

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

**Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194`

##### ParametersExpand Collapse 

account\_id: str

Identifier.

maxLength32

cursor: Optional\[str\]

Opaque token from a previous response’s `result_info.cursor`. Pass this value to fetch the next page of results. Omit (or pass an empty string) for the first page.

maxLength256

direction: Optional\[Literal\["asc", "desc"\]\]

Sort direction for results. Defaults to ascending order.

One of the following:

"asc"

"desc"

name: Optional\[str\]

Filter extensions by exact name match. For example, `name=com` returns only the `com` extension.

per\_page: Optional\[int\]

Number of items to return per page.

maximum50

minimum1

sort\_by: Optional\[Literal\["name", "created\_at", "updated\_at"\]\]

Column to sort results by. Defaults to `name` when omitted.

One of the following:

"name"

"created\_at"

"updated\_at"

##### ReturnsExpand Collapse 

class ExtensionListResponse: …

Extension entry with metadata and JSON Schema documents for the registration operation.

metadata: Metadata

Extension metadata.

name: str

The full name of the extension. For example, “co.uk”, or “uk”.

tld: str

The TLD of the extension. For example, for “co.uk”, it is “uk”. For “uk”, it is “uk”.

registration\_schema: object

JSON Schema describing the expected input structure for registration operations on this extension.

### List extensions

Python

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
page = client.registrar_sandbox.extensions.list(
    account_id="023e105f4ecef8ad9ca31a8372d0c353",
)
page = page.result[0]
print(page.metadata)
```

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "metadata": {
        "name": "name",
        "tld": "tld"
      },
      "registration_schema": {}
    }
  ],
  "success": true,
  "result_info": {
    "count": 0,
    "cursor": "cursor",
    "per_page": 0
  }
}
```

##### Returns Examples

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "metadata": {
        "name": "name",
        "tld": "tld"
      },
      "registration_schema": {}
    }
  ],
  "success": true,
  "result_info": {
    "count": 0,
    "cursor": "cursor",
    "per_page": 0
  }
}
```