List TLDs

​

Returns a paginated list of TLDs in the order defined in the config file. By default, only enabled TLDs are returned.

Filters

  • status: enabled (default), disabled, or all
  • category: Comma-separated list of gtld, ngtld, cctld, stld
  • exclude: Comma-separated TLD names to omit from results (e.g., com,net)

Categories

Category Description
gtld Generic TLDs (.com, .net, .org)
ngtld New Generic TLDs post-2012 (.app, .dev, .xyz)
cctld Country Code TLDs (.io, .ai, .in)
stld Sponsored TLDs (.edu, .gov)
Query Parameters
  • status
    Type: string

    Filter by status: enabled (default), disabled, all

  • category
    Type: string

    Filter by category (comma-separated): gtld, ngtld, cctld, stld

  • exclude
    Type: string

    Comma-separated TLD names to exclude (e.g., com,net)

  • limit
    Type: integer

    Items per page (default 100, max 500)

  • cursor
    Type: string

    Pagination cursor for next page

Responses
  • application/json
Request Example for get/tlds
curl 'https://api.nametrust.com/tlds?status=&category=&exclude=&limit=1&cursor='

{
  "object": "list",
  "items": [
    {
      "object": "tld",
      "name": "com",
      "category": "gtld"
    }
  ],
  "pages": {
    "object": "cursor",
    "has_prev": true,
    "direction": "next",
    "cursor": "abc123",
    "next_cursor": "def456",
    "prev_cursor": "xyz789",
    "page": 2,
    "total_pages": 10,
    "total_items": 100,
    "limit": 20,
    "has_next": true
  }
}

Paginated list of TLDs