1. Kennisbank
  2. API
  3. Transfers : transfer

Transfers : transfer

  • Aangemaakt : 16-07-2025
  • Laatste update: -

Omschrijving

Verhuis een bestaande domeinnaam

Endpoint


Parameters

Parameter Datatype Verplicht Omschrijving
registrant String Ja Contact handle van de nieuwe registrant
contacts Array Ja array met objecten nieuwe contacten:
type: Type van het contact: admin, tech of billing
handle: De handle van het contact
dns_hosted Boolean Nee Of de domeinnaam gebruik maakt van de nameservers van NextName of zelf gespecificeerde nameservers
nsgroup String Nee De nameservergroup die opgegeven moet worden bij de domeinnaam, alleen verplicht als dns_hosted = false
dns_hosted_template String Nee De DNS template die bij de domeinnaam ingesteld moet worden, alleen beschikbaar als de nameservers van NextName gebruikt worden
transfer_lock Boolean Nee Transfer lock van de domeinnaam : true voor aan, false voor uit

Indien deze parameter niet wordt meegegeven en een transfer_lock is beschikbaar voor de extensie dan wordt deze standaard geactiveerd.
auto_renewal Boolean Nee Automatisch verlengen van de domeinnaam in- of uitschakelen.

Indien deze parameter niet wordt meegegeven dan wordt de automatisch verlengen ingeschakeld.
services Array Nee Extra diensten die geactiveerd moeten worden bij de domeinnaam. Mogelijke waarden:
trustee: Trustee contact voor de domeinnaam
premium_price_accept Object Nee De prijs van een premium domeinnaam accepteren met het volgende object:
currency: string: de munteenheid van de premium prijs
price: float: de premium prijs van de domeinnaam
auth_code String Nee Auth-code van de domeinnaam.
Alleen verplicht wanneer de extensie authcodes ondersteunt, meer informatie : Sheet view alle extensies

Test domeinnamen

In de testomgeving van de API zijn 50 domeinnamen beschikbaar om verhuizingen te testen.
Domeinnaam Auth Code
test-transfer-domain-1.nlK7M9P2N8Q5R1
test-transfer-domain-2.nlX3W6Y9Z2A5B8
test-transfer-domain-3.nlC1D4F7G0H3J6
test-transfer-domain-4.nlL9M2N5P8Q1R4
test-transfer-domain-5.nlS7T0U3V6W9X2
test-transfer-domain-6.nlY5Z8A1B4C7D0
test-transfer-domain-7.nlE3F6G9H2I5J8
test-transfer-domain-8.nlK1L4M7N0P3Q6
test-transfer-domain-9.nlR9S2T5U8V1W4
test-transfer-domain-10.nlX7Y0Z3A6B9C2
test-transfer-domain-11.nlF4G7H0I3J6K9
test-transfer-domain-12.nlM2N5P8Q1R4S7
test-transfer-domain-13.nlT0U3V6W9X2Y5
test-transfer-domain-14.nlZ8A1B4C7D0E3
test-transfer-domain-15.nlF6G9H2I5J8K1
test-transfer-domain-16.nlL4M7N0P3Q6R9
test-transfer-domain-17.nlS2T5U8V1W4X7
test-transfer-domain-18.nlY0Z3A6B9C2D5
test-transfer-domain-19.nlE8F1G4H7I0J3
test-transfer-domain-20.nlK6L9M2N5P8Q1
test-transfer-domain-21.nlR4S7T0U3V6W9
test-transfer-domain-22.nlX2Y5Z8A1B4C7
test-transfer-domain-23.nlD0E3F6G9H2I5
test-transfer-domain-24.nlJ8K1L4M7N0P3
test-transfer-domain-25.nlQ6R9S2T5U8V1
test-transfer-domain-26.comdE!6fG%1hI
test-transfer-domain-27.comjK+4lM#9nO
test-transfer-domain-28.compQ&7rS*2tU
test-transfer-domain-29.comvW@5xY%0zA
test-transfer-domain-30.combC!8dE#3fG
test-transfer-domain-31.comhI*6jK&1lM
test-transfer-domain-32.comnO+4pQ%9rS
test-transfer-domain-33.comtU@7vW*2xY
test-transfer-domain-34.comzA!5bC#0dE
test-transfer-domain-35.comfG&8hI%3jK
test-transfer-domain-36.comlM*6nO!1pQ
test-transfer-domain-37.comrS+4tU@9vW
test-transfer-domain-38.comxY&7zA*2bC
test-transfer-domain-39.comdE!5fG%0hI
test-transfer-domain-40.comjK*8lM#3nO
test-transfer-domain-41.compQ&6rS!1tU
test-transfer-domain-42.comvW+4xY@9zA
test-transfer-domain-43.combC*7dE&2fG
test-transfer-domain-44.comhI!5jK%0lM
test-transfer-domain-45.comnO@8pQ*3rS
test-transfer-domain-46.comtU&6vW!1xY
test-transfer-domain-47.comzA+4bC@9dE
test-transfer-domain-48.comfG*7hI&2jK
test-transfer-domain-49.comlM!5nO%0pQ
test-transfer-domain-50.comrS@8tU*3vW

Antwoord

Indien de domeinnaam direct is verhuisd: Indien de verhuizing in behandeling is genomen

Voorbeelden


Beschrijving:
verhuis een .NL domeinnaam met eigen gespecificeerde nameservers

Opdracht in PHP: 
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/transfers/test-transfer-domain-1.nl";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$a_data = ["contacts" => [
                          ["type" => "admin", "handle" => "CONTACTHANDLE-1"],
                          ["type" => "tech", "handle" => "CONTACTHANDLE-1"]
                         ],
           "nsgroup" => "MY-NSGROUP-1",
           "auto_renewal" => true,
           "auth_code" => "K7M9P2N8Q5R1"];

$json_data = json_encode($a_data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data );
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key","Content-Type: application/json"));
$output = curl_exec($ch);

$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if($http_code === 200) {
  echo "Domain name successfully transferred";
}
elseif($http_code === 202) {
  echo "Transfer successfully requested";
}

curl_close($ch);
Opdracht in cURL: 
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{"registrant": "CONTACTHANDLE-1", "contacts":[{"type":"admin","handle":"CONTACTHANDLE-1"},{"type":"tech","handle":"CONTACTHANDLE-1"}], "nsgroup" : "MY-NSGROUP-1", "auto_renewal": true, "auth_code": "K7M9P2N8Q5R1" }' \
https://api-test.nextname.nl/v2/transfers/test-transfer-domain-1.nl
Antwoord: 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "transfer_id": "0a363d52bb6f6549",
  "transfer_type": "standard",
  "status": "completed",
  "date_expiry": "2025-09-25T00:00:00Z"
}

Beschrijving:
Verhuis een .COM domeinnaam

Opdracht in PHP: 
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/transfers/test-transfer-domain-25.com";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$a_data = ["registrant" => "CONTACTHANDLE-1",
           "contacts" => [
                          ["type" => "admin", "handle" => "CONTACTHANDLE-1"],
                          ["type" => "tech", "handle" => "CONTACTHANDLE-1",
                          "type" => "billing", "handle" => "CONTACTHANDLE-1"]
                         ],
           "dns_hosted" => true,
           "dns_hosted_template" => "MY-TEMPLATE",
           "auto_renewal" => true,
           "auth_code" => "wX*3yZ@8aC"];


          ];

$json_data = json_encode($a_data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data );
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key","Content-Type: application/json"));
$output = curl_exec($ch);

$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if($http_code === 200) {
  echo "Domain name successfully transferred";
}
elseif($http_code === 202) {
  echo "Transfer successfully requested";
}

curl_close($ch);
Opdracht in cURL: 
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{"registrant": "CONTACTHANDLE-1", "contacts":[{"type":"admin","handle":"CONTACTHANDLE-1"},{"type":"tech","handle":"CONTACTHANDLE-1"},{"type":"billing","handle":"CONTACTHANDLE-1"}], "dns_hosted": true, "dns_hosted_template": "MY-TEMPLATE", "auto_renewal": true, "auth_code": "wX*3yZ@8aC"}' \
https://api-test.nextname.nl/v2/transfers/test-transfer-domain-25.com
Antwoord: 
HTTP/1.1 202 Accepted
Content-Type: application/json;charset=utf-8

{
  "transfer_id": "b73e408171f8393g",
  "transfer_type": "standard",
  "status": "pending",
  "message": "Transfer waiting for Losing Registrar Approval",
  "estimated_completion": {
    "date_earliest": "2025-07-22T04:00:00Z",
    "date_latest": "2025-07-22T07:00:00Z"
  }
}

API Documentatie

Versie V2.3b, 16-07-2025