NextName Kennisbank

TLDs : info

  • Aangemaakt: 01-05-2026

Omschrijving

Haal alle informatie van een TLD

Endpoint

Parameters

Parameter Datatype Verplicht Omschrijving
lang String Nee De taal van de beschrijvingen van de TLD specifieke parameters.
Mogelijke waarden: nl = Nederlands, en = Engels, all = alle beschikbare talen

Antwoord

Parameter Type Omschrijving
tld String De domeinextensie
category String Categorie van de extensie:
gTLD: generic TLD
ccTLD: country code TLD
continent String Continent waar de TLD aan gekoppeld is. NULL voor gTLDs. Mogelijke waarden: EU, AS, NA, SA, AF, OC, AN
country_code String ISO 3166-1 alpha-2 landcode. NULL voor gTLDs
syntax Object Object met de syntax-eisen voor de domeinnaam:
min_length: Minimaal aantal karakters van de SLD (integer)
max_length: Maximaal aantal karakters van de SLD (integer)
idn: Object met IDN (Internationalized Domain Name) ondersteuning:
  supported: Of IDN ondersteund wordt (boolean)
  type: Het type IDN-validatie, bijvoorbeeld UTS46 of UTS46_2003. NULL als IDN niet ondersteund wordt (string)
  allowed_characters: String met alle toegestane karakters voor IDN-domeinnamen, NULL als niet ondersteund (string)
  languages: Array met talen die ondersteund worden voor IDN, in ISO 639-2 alpha-3 codering. NULL als niet ondersteund of als de registry geen taal-restrictie hanteert (array)
registry Object Informatie over de registry die de TLD beheert:
name: Naam van de registry (string)
url: URL van de registry-website (string)
backend_operator: Naam van de technische backend-operator als deze afwijkt van de registry. NULL als gelijk aan registry (string)
policies Object URLs naar het beleid van de registry:
registration_terms_url: URL naar de algemene voorwaarden voor registratie (string)
registrant Object Eisen aan de houder (registrant) van de domeinnaam:
organization_allowed: Of een bedrijfsnaam opgegeven mag worden (boolean)
organization_required: Of een bedrijfsnaam verplicht is (boolean)
allowed_countries: Komma-gescheiden lijst van toegestane landcodes (ISO 3166-1 alpha-2). NULL als er geen geografische restrictie geldt (string)
contacts Object Eisen aan de contacten van de domeinnaam, met sub-objecten admin, tech en billing. Elk sub-object bevat:
min: Minimaal aantal vereiste contacten van dit type (integer)
max: Maximaal aantal toegestane contacten van dit type (integer)
organization_allowed: Of een bedrijfsnaam opgegeven mag worden (boolean)
organization_required: Of een bedrijfsnaam verplicht is (boolean)
nameservers Object Eisen aan de nameservers van de domeinnaam:
min: Minimaal aantal vereiste nameservers (integer)
max: Maximaal aantal toegestane nameservers (integer)
required: Of nameservers verplicht zijn bij registratie (boolean)
hosts: Object met IP-adres eisen per nameserver:
  ipv4: Object met min en max aantal IPv4-adressen per nameserver (integers)
  ipv6: Object met min en max aantal IPv6-adressen per nameserver (integers)
pre_delegation_check: Object met informatie over zone-validatie vóór registratie:
  required: Of een zone-check verplicht is vóór registratie (boolean)
  url: URL naar de zone-check tool van de registry. NULL als geen tool beschikbaar (string)
dnssec Object DNSSEC-ondersteuning door de registry:
supported: Of DNSSEC ondersteund wordt (boolean)
max_records: Maximaal aantal DNSSEC-records per domeinnaam (integer)
allowed_algorithms: Array met toegestane DNSSEC algoritme-nummers conform IANA registry (array van integers)
zone Object Informatie over publicatie van de zone-bestanden:
publication_schedule_cron: Cron-expressie (UTC) die aangeeft wanneer de registry de zone publiceert. NULL als de registry continu publiceert of geen schema bekend is (string)
propagation_delay_seconds: Geschatte propagatie-tijd in seconden tussen publicatie en wereldwijde DNS-beschikbaarheid. NULL als onbekend (integer)
periods Object Informatie over registratie-, verlengings- en transfer-periodes:
create_months: Array van toegestane periodes (in maanden) voor nieuwe registraties (array van integers)
renew_months: Array van toegestane periodes (in maanden) voor verlengingen (array van integers)
auto_renew_months: Array van toegestane periodes (in maanden) voor automatische verlengingen (array van integers)
renewal_offset_seconds: Aantal seconden ten opzichte van de expiry-datum waarop NextName de auto-renewal uitvoert. Negatieve waarde betekent vóór expiry, 0 betekent op de expiry-datum zelf (integer)
auth_code Object Informatie over de auth-code (transfercode) van de domeinnaam:
required_for_transfer: Of een auth-code vereist is bij een transfer (boolean)
required_for_trade: Of een auth-code vereist is bij een trade (houderwijziging) (boolean)
retrievable: Of de auth-code opvraagbaar is via de API (boolean)
resettable: Of de auth-code opnieuw aangevraagd of vervangen kan worden (boolean)
custom_value_allowed: Of een eigen auth-code waarde opgegeven mag worden (boolean)
sent_to_registrant_email: Of de registry de auth-code naar het e-mailadres van de registrant stuurt (boolean)
registrant_self_service: Of de registrant zelf de auth-code kan opvragen via de registry (boolean)
registrant_self_service_url: URL naar de self-service pagina van de registry. NULL als niet beschikbaar (string)
expires_after_seconds: Aantal seconden waarna de auth-code verloopt na uitgifte. NULL als de auth-code niet verloopt (integer)
format: Object met formaat-eisen voor de auth-code:
  name: Naam van het format zoals gehanteerd door de registry, bijvoorbeeld token of AuthInfo (string)
  pattern: Regex-patroon dat een geldige auth-code beschrijft (string)
  length_min: Minimum aantal karakters (integer)
  length_max: Maximum aantal karakters (integer)
  example: Voorbeeld van een geldige auth-code (string)
transfer Object Gedrag van de registry bij een transfer:
renewal_behavior: Hoe de registry de expiry-datum aanpast bij een transfer. Mogelijke waarden:
  extend_one_year: De expiry wordt met 1 jaar verlengd
  extend_one_year_in_grace_period: De expiry wordt alleen met 1 jaar verlengd als de domeinnaam in grace-periode zit
  keep_expiration: De expiry blijft ongewijzigd
  reset_term: De registratie-periode wordt gereset (string)
expiration Object Periodes na het verlopen van een domeinnaam:
grace_days: Aantal dagen na expiry waarin de registratie kosteloos teruggedraaid kan worden. NULL als geen grace-periode (integer)
redemption_days: Aantal dagen na expiry waarin de domeinnaam nog teruggehaald kan worden via een restore-procedure. NULL als geen redemption-periode (integer)
available_actions Object Welke acties de registry ondersteunt voor deze TLD:
register: Nieuwe registratie (boolean)
renew: Verlengen (boolean)
transfer: Verhuizen (boolean)
trade: Houderwijziging (boolean)
delete: Opheffen (boolean)
restore: Terughalen na expiry (boolean)
auto_renew: Automatisch verlengen (boolean)
update_contacts: Wijzigen van contacten (boolean)
update_nameservers: Wijzigen van nameservers (boolean)
features Object Optionele features die de registry biedt:
premium_domains: Of de registry premium-pricing op TLD-niveau hanteert (boolean)
transfer_lock: Of een transfer lock door de registry ondersteund wordt (boolean)
lookup Object Lookup-services voor de TLD:
whois_server: Hostname van de WHOIS-server. NULL als geen WHOIS beschikbaar (string)
whois_web_url: URL van de WHOIS-zoekpagina van de registry. NULL als geen pagina beschikbaar (string)
rdap_url: Basis-URL van de RDAP-service van de registry conform IANA RDAP bootstrap. NULL als geen RDAP beschikbaar (string)
services Object Door NextName aangeboden diensten voor deze TLD:
trustee_available: Of NextName een trustee-service aanbiedt voor klanten die niet aan de eligibility-vereisten voldoen.
  true: TLD heeft eligibility-vereisten en NextName biedt trustee aan
  false: TLD heeft eligibility-vereisten maar geen trustee-service beschikbaar
  null: TLD heeft geen eligibility-vereisten, trustee niet van toepassing (boolean of NULL)
registry_lock_available: Of de registry een registry lock aanbiedt voor extra beveiliging tegen ongeautoriseerde wijzigingen (boolean)
contact_properties Object Extra contactvelden die de registry vereist of accepteert. NULL als de TLD geen extra velden vereist. Het object bevat:
registry_identifier: Identifier van de registry-set, bijvoorbeeld SIDN (string)
fields: Array met extra velden. Elk veld is een object bestaande uit:
  id: Veldnaam zoals gebruikt door de registry (string)
  label: Label voor het veld in de gekozen taal. Bij lang=all een object met taalcodes als sleutels (string of object)
  type: Datatype van het veld. Mogelijke waarden: text, select, date (string)
  relevant_for: Array met entity-types waarvoor dit veld relevant is. Mogelijke waarden: company, person (array van strings)
  required_for: Array met entity-types waarvoor dit veld verplicht is. Een leeg array betekent dat het veld optioneel is. Voor velden die alleen onder bepaalde voorwaarden verplicht zijn, zie de info-tekst (array van strings)
  example: Voorbeeldwaarde voor het veld. Bij lang=all een object met taalcodes als sleutels. NULL als geen voorbeeld beschikbaar (string of object)
  info: Beschrijvende tekst voor het veld. Plain text, waarbij \n\n een paragraaf-scheiding markeert. Bij lang=all een object met taalcodes als sleutels. NULL als geen info beschikbaar (string of object)
  options: Array met toegestane keuzes voor select-velden. NULL voor text en date velden. Elk option-object bestaat uit:
    value: De waarde die naar de registry verstuurd wordt (string)
    label: Het label dat aan de eindgebruiker getoond wordt. Bij lang=all een object met taalcodes als sleutels (string of object)
date_last_updated Datetime Datum en tijdstip waarop deze TLD-gegevens voor het laatst zijn bijgewerkt (UTC tijdzone in RFC 3339)

Voorbeeld

Beschrijving:

Haal de details van een domeinnaam op

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/tlds/info/nl";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;
Opdracht in cURL:
curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.nextname.nl/v2/tlds/info/nl

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
{
  "tld": "nl",
  "category": "ccTLD",
  "continent": "EU",
  "country_code": "NL",
  "syntax": {
    "min_length": 2,
    "max_length": 63,
    "idn": {
      "supported": false,
      "type": null,
      "allowed_characters": null,
      "languages": null
    }
  },
  "registry": {
    "name": "SIDN",
    "url": "https://www.sidn.nl",
    "backend_operator": null
  },
  "policies": {
    "registration_terms_url": "https://www.sidn.nl/en/about-sidn/general-terms-and-conditions"
  },
  "registrant": {
    "organization_allowed": true,
    "organization_required": false,
    "allowed_countries": null
  },
  "contacts": {
    "admin": {
      "min": 1,
      "max": 1,
      "organization_allowed": true,
      "organization_required": false
    },
    "tech": {
      "min": 1,
      "max": 1,
      "organization_allowed": true,
      "organization_required": false
    },
    "billing": {
      "min": 0,
      "max": 1,
      "organization_allowed": true,
      "organization_required": false
    }
  },
  "nameservers": {
    "min": 2,
    "max": 13,
    "required": false,
    "hosts": {
      "ipv4": {
        "min": 1,
        "max": 10
      },
      "ipv6": {
        "min": 0,
        "max": 9
      }
    },
    "pre_delegation_check": {
      "required": false,
      "url": null
    }
  },
  "dnssec": {
    "supported": true,
    "max_records": 4,
    "allowed_algorithms": [
      3,
      5,
      6,
      7,
      8,
      10,
      12,
      13,
      14,
      15,
      16
    ]
  },
  "zone": {
    "publication_schedule_cron": "*/30 * * * *",
    "propagation_delay_seconds": 1200
  },
  "periods": {
    "create_months": [
      12
    ],
    "renew_months": [
      12
    ],
    "auto_renew_months": [
      12
    ],
    "renewal_offset_seconds": 0
  },
  "auth_code": {
    "required_for_transfer": true,
    "required_for_trade": false,
    "retrievable": true,
    "resettable": false,
    "custom_value_allowed": false,
    "sent_to_registrant_email": false,
    "registrant_self_service": false,
    "registrant_self_service_url": null,
    "expires_after_seconds": null,
    "format": {
      "name": "token",
      "pattern": "^[A-Z0-9]{12}$",
      "length_min": 12,
      "length_max": 12,
      "example": "AB12CD34EF56"
    }
  },
  "transfer": {
    "renewal_behavior": "keep_expiration"
  },
  "expiration": {
    "grace_days": null,
    "redemption_days": 40
  },
  "available_actions": {
    "register": true,
    "renew": true,
    "transfer": true,
    "trade": true,
    "delete": true,
    "restore": true,
    "auto_renew": true,
    "update_contacts": true,
    "update_nameservers": true
  },
  "features": {
    "premium_domains": false,
    "transfer_lock": false
  },
  "lookup": {
    "whois_server": "whois.domain-registry.nl",
    "whois_web_url": null,
    "rdap_url": "https://rdap.sidn.nl/"
  },
  "services": {
    "trustee_available": null,
    "registry_lock_available": true
  },
  "contact_properties": {
    "registry_identifier": "SIDN",
    "fields": [
      {
        "id": "legal_form",
        "label": "Rechtsvorm",
        "type": "select",
        "relevant_for": [
          "company"
        ],
        "required_for": [
          "company"
        ],
        "example": null,
        "info": "De officiële rechtsvorm van het bedrijf, zoals geregistreerd bij de Kamer van Koophandel.",
        "options": [
          { "value": "ANDERS", "label": "Anders" },
          { "value": "BGG", "label": "Buitenlandse EG vennootschap" },
          { "value": "BRO", "label": "Buitenlandse onderneming/nevenvestiging" },
          { "value": "BV", "label": "Besloten Vennootschap" },
          { "value": "BVI/O", "label": "B.V. in oprichting" },
          { "value": "COOP", "label": "Cooperatie" },
          { "value": "CV", "label": "Commanditaire Vennootschap" },
          { "value": "EENMANSZAAK", "label": "Eenmanszaak" },
          { "value": "EESV", "label": "Europees Economisch Samenwerkingsverband" },
          { "value": "ENV", "label": "Europese NV (SE) met gewone structuur" },
          { "value": "MAATSCHAP", "label": "Maatschap" },
          { "value": "KERK", "label": "Kerkgenootschap" },
          { "value": "NV", "label": "Naamloze Vennootschap" },
          { "value": "OWM", "label": "Onderlinge Waarborg Maatschappij" },
          { "value": "PUBL", "label": "Publiekrechtelijke Rechtspersoon" },
          { "value": "REDR", "label": "Rederij" },
          { "value": "STICHTING", "label": "Stichting" },
          { "value": "VERENIGING", "label": "Vereniging" },
          { "value": "VOF", "label": "Vennootschap onder firma" }
        ]
      },
      {
        "id": "legal_form_regno",
        "label": "KVK-nummer",
        "type": "text",
        "relevant_for": [
          "company"
        ],
        "required_for": [
          "company"
        ],
        "example": "12345678",
        "info": "KVK-nummer van de onderneming. Via de website van de KVK (https://www.kvk.nl/zoeken/) kunnen KVK-nummers gecontroleerd worden.",
        "options": null
      }
    ]
  },
  "date_last_updated": "2026-05-04T07:37:17Z"
}