TLDs : info
Omschrijving
Haal alle informatie van een TLD
Endpoint
GET https://api.nextname.nl/v2/tlds/info/tld
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
HTTP status code: 200 Ok
| 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"
}