# list_domain_extensions

Source: https://modulify.ai/docs/api/bought-domains/list-domain-extensions

Lists the extensions Modulify sells with what each one costs to register and renew, the price list the Domains page shows.

- Title: List domain extensions and their prices
- Scope: `domains:read`
- Access: Read only
- Endpoint: `POST /v1/list_domain_extensions`

Pass `featured` as `true` for the extensions Modulify features, the ones a bare name is checked against, in that order starting with `com`. Pass `tlds` to price only the extensions you name. Leave both out for every extension on sale, sorted by name.

The answer carries `Currency` and `Extensions`, one row per extension with `Tld`, `Featured`, `Registration` and `Renewal`. `Registration.PriceCents` is what registering an ordinary name costs for `Registration.Years` years, the shortest term the extension is sold for, and `Renewal.PriceCents` is what renewing one costs for `Renewal.Years` years, or `null` when Name.com gives no renewal price, both in US cents. A premium name costs more, and only `search_available_domains` gives its price.

Asking for a single extension that is not on sale is refused, for example with `.local domains are not for sale!`, and in a longer list it is left out. Listing them needs no workspace and never asks Name.com, so it has no limit. To check whether a name is free, use `search_available_domains`. To read the same list from a website without a token, use [List prices](https://modulify.ai/docs/publish/domain-http-api#list-prices) in the Domain HTTP API. See [Search for a name](https://modulify.ai/docs/publish/buy-a-domain#search-for-a-name).

## Request

Call it with a `POST` to `https://api.modulify.ai/v1/list_domain_extensions`, sending the inputs below as a JSON object. The token needs the `domains:read` scope.

It only reads and changes nothing, so retrying it is safe.

```bash
curl -X POST https://api.modulify.ai/v1/list_domain_extensions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Over MCP, the same method is the [list_domain_extensions tool](https://modulify.ai/docs/mcp/bought-domains/list-domain-extensions).

## Inputs

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `featured` | boolean | No | `true` lists only the featured extensions, in the order a bare name is checked against them. |
| `tlds` | array of strings | No | Extensions to price, such as `com` or `co.uk`, up to 100, each up to 63 characters. Leave it out to list every extension. |

## Response

Every call answers with the [JSON envelope](https://modulify.ai/docs/api/requests-and-responses#the-response) of `success`, `message`, `data`, `code` and `version`. `data` holds the result described above, and on a method that returns a total, `count` carries it. The [response headers](https://modulify.ai/docs/api/requests-and-responses#headers-on-every-method-call) carry the call's `X-Request-Id` and what is left of your per-minute budget in `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`. [Errors](https://modulify.ai/docs/api/errors) explains every status code a call can answer with.