---
title: "List TLDs"
method: GET
path: "/2/tld"
tags: ["Tld"]
---

# List TLDs

`GET /2/tld`

List all TLDs

## Query parameters

- `with` string
- `groups` integer[], nullable — Filter by groups

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 6a791d9bApiDomainTld[]
    - `id` integer, required — TLD ID
    - `tld` string, required — Top-level domain
    - `is_idn` boolean — Is Internationalized Domain Name
    - `groups` 6a791d9bApiDomainTldGroup[] — List of the TLD groups
      - `id` integer, required — TLD group ID
      - `name` string, required — TLD group name
    - `registration_delay` object — Required time range for registration
      - `min` integer — Minimal required time for registration in minutes
      - `max` integer — Maximum required time for registration in minutes
    - `transfer_delay` integer — Required time for the transfer
    - `trade_delay` object — Required time range for trade (not set if trade not allowed)
      - `min` integer — Minimal required time for trade in minutes
      - `max` integer — Maximum required time for trade in minutes
    - `outgoing_transfer_delay` integer — Required time for outgoing transfer
    - `domain_length` string
    - `periods` object — Domain lifecycle periods
      - `renew_grace` integer — Time after domain expiry during which it can still be renewed without extra fees or loss of ownership. (days)
      - `redemption` integer — Time after grace period during which the domain can be redeemed with additional fees. (days)
      - `deletion` integer — Period after redemption period during which the domain is purged from registry and becomes available for re-registration. (days)
    - `support` object — Supported features of the TLD
      - `dns_anycast` boolean
      - `domain_privacy` boolean
      - `transfer_lock` boolean
      - `renew_on_transfer` boolean
      - `preconfigured_dns` boolean
      - `dnssec` boolean
    - `renewal_periods` integer[] — All the available renewal periods. (years)
    - `registration_periods` integer[] — All the available registration periods. (years)
    - `outgoing_transfer_need` object — Outgoing transfer method
      - `auth_code` boolean — Outgoing transfer method requires Auth Code
      - `auth_code_length` integer — Length of the authorization code needed for domain transfers.
      - `ips_tag` boolean — Outgoing transfer method requires IPs Tag
    - `fields` 6a791d9bApiDomainTldFields
      - `contacts` 6a791d9bApiDomainContactField[] — The required contact informations
        - `type` 'checkbox' | 'contact_id' | 'date' | 'email' | 'info' | 'phone' | 'radio' | 'select' | 'text' | 'warning', required — Type of the field
        - `contact_type` object, required — Type of the contact
        - `name` string, required — Name of the field
        - `required` boolean, required — Is the contact required
        - `transfer` boolean, required — Is the contact required on transfer
        - `trade` boolean, required — Is the contact required on trade
        - `restricted_fields` 6a791d9bApiDomainTldField[] — All the contact fields that has a guideline
          - `type` 'checkbox' | 'contact_id' | 'date' | 'email' | 'info' | 'phone' | 'radio' | 'select' | 'text' | 'warning', required — Type of the field
          - `name` string, required — Name of the field
          - `required` boolean, required — Is the field required
          - `description` string — Description of the field
          - `guideline` string — Field error validation message
          - `min_length` integer — Field value minimum length
          - `max_length` integer — Field value maximum length
          - `pattern` string — Field validation pattern
          - `note` string — Additional description of the field
          - `default` string — Field default value
          - `options` 6a791d9bApiDomainTldFieldOptions[] — Field possible values
            - `name` string, required — Key of the value
            - `value` string, required — Field possible value
          - `required_conditions` 6a791d9bApiDomainTldFieldCondition[] — Field required condition (if set determines the requirability of the field, if not set refer to the 'required' boolean)
            - `field` string, required — The field targeted by the condition
            - `operator` string, required — The condition operator
            - `value` string, required — The value of the condition
            - `contact` 'admin' | 'billing' | 'owner' | 'tech' — The contact targeted by the condition
            - `logic` 'AND' | 'OR' — The logical operator linking the previous and current condition
      - `description` string — Additional fields description
      - `registration` 6a791d9bApiDomainTldField[] — The required additional fields on registration
        - `type` 'checkbox' | 'contact_id' | 'date' | 'email' | 'info' | 'phone' | 'radio' | 'select' | 'text' | 'warning', required — Type of the field
        - `name` string, required — Name of the field
        - `required` boolean, required — Is the field required
        - `description` string — Description of the field
        - `guideline` string — Field error validation message
        - `min_length` integer — Field value minimum length
        - `max_length` integer — Field value maximum length
        - `pattern` string — Field validation pattern
        - `note` string — Additional description of the field
        - `default` string — Field default value
        - `options` 6a791d9bApiDomainTldFieldOptions[] — Field possible values
          - `name` string, required — Key of the value
          - `value` string, required — Field possible value
        - `required_conditions` 6a791d9bApiDomainTldFieldCondition[] — Field required condition (if set determines the requirability of the field, if not set refer to the 'required' boolean)
          - `field` string, required — The field targeted by the condition
          - `operator` string, required — The condition operator
          - `value` string, required — The value of the condition
          - `contact` 'admin' | 'billing' | 'owner' | 'tech' — The contact targeted by the condition
          - `logic` 'AND' | 'OR' — The logical operator linking the previous and current condition
      - `transfer` 6a791d9bApiDomainTldField[] — The required additional fields on transfer
        - `type` 'checkbox' | 'contact_id' | 'date' | 'email' | 'info' | 'phone' | 'radio' | 'select' | 'text' | 'warning', required — Type of the field
        - `name` string, required — Name of the field
        - `required` boolean, required — Is the field required
        - `description` string — Description of the field
        - `guideline` string — Field error validation message
        - `min_length` integer — Field value minimum length
        - `max_length` integer — Field value maximum length
        - `pattern` string — Field validation pattern
        - `note` string — Additional description of the field
        - `default` string — Field default value
        - `options` 6a791d9bApiDomainTldFieldOptions[] — Field possible values
          - `name` string, required — Key of the value
          - `value` string, required — Field possible value
        - `required_conditions` 6a791d9bApiDomainTldFieldCondition[] — Field required condition (if set determines the requirability of the field, if not set refer to the 'required' boolean)
          - `field` string, required — The field targeted by the condition
          - `operator` string, required — The condition operator
          - `value` string, required — The value of the condition
          - `contact` 'admin' | 'billing' | 'owner' | 'tech' — The contact targeted by the condition
          - `logic` 'AND' | 'OR' — The logical operator linking the previous and current condition
    - `idn` 6a791d9bApiDomainIdnTables[] — List of all the IDN languages accepted
      - `language` string, required — The language name
      - `characters` string[], required — List of allowed characters

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/158a854b0c7d/schema)