List domain extensions and their prices

list_domain_extensions

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

POST /v1/list_domain_extensionsScopedomains:readRead only

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 in the Domain HTTP API. See 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.

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.

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 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 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 explains every status code a call can answer with.