---
title: List extensions
---

[Skip to content](#%5Ftop) 

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

[Registrar](https://developers.cloudflare.com/api/resources/registrar)

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

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# List extensions

GET/accounts/{account\_id}/registrar/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`

##### Path ParametersExpand Collapse 

account\_id: string

Identifier.

maxLength32

##### Query ParametersExpand Collapse 

cursor: optional string

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 "asc" or "desc"

Sort direction for results. Defaults to ascending order.

One of the following:

"asc"

"desc"

name: optional string

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

per\_page: optional number

Number of items to return per page.

maximum50

minimum1

sort\_by: optional "name" or "created\_at" or "updated\_at"

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

One of the following:

"name"

"created\_at"

"updated\_at"

##### ReturnsExpand Collapse 

errors: array of object { code, message, source } 

code: number

minimum1000

message: string

source: optional object { pointer } 

Location of the invalid value that caused the error.

pointer: string

JSON Pointer to the invalid or missing request value.

messages: array of object { code, message, source } 

code: number

minimum1000

message: string

source: optional object { pointer } 

Location of the invalid value that caused the error.

pointer: string

JSON Pointer to the invalid or missing request value.

result: array of object { metadata, registration\_schema } 

metadata: object { name, tld } 

Extension metadata.

name: string

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

tld: string

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

registration\_schema: unknown

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

success: true

Whether the API call was successful.

result\_info: optional object { count, cursor, per\_page } 

Cursor-based pagination metadata.

count: optional number

Number of items in the current result set.

cursor: optional string

Opaque token for the next page. Empty string when no more pages.

per\_page: optional number

Number of items per page.

### List extensions

HTTP

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/extensions \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```

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
  }
}
```