Transfers : Details

Aangemaakt : 16-07-2025
Laatste update:

Omschrijving

Haal alle informatie op van een verhuizing uit het account

Endpoint

GET https://api.nextname.nl/v2/transfers/domain/transfer_id

transfer_id is optioneel, wanneer alleen de domeinnaam wordt opgegeven dan wordt de meest recente verhuizing opgevraagd

Parameters

Bij dit commando worden geen extra parameters opgegeven

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
domain_name	String	Domeinnaam
transfer_id	String	Unieke ID voor de verhuizing
type	String	Type verhuizing Mogelijke waarden: standard Het betreft een normale verhuizing vanaf een andere registrar internal De domeinnaam is afkomstig van een andere reseller bij NextName registry_action De verhuizing is uitgevoerd in opdracht van de registry bulk_operation De domeinnaam is verhuisd als onderdeel van een bulk operatie (b.v. een bulk verhuizing)
direction	String	Inkomende of uitgaande verhuizing: inbound of outbound
status	String	De status van de verhuizing Mogelijke waarden: pending De verhuizing is in behandeling failed De verhuizing is mislukt en is niet langer actief completed De verhuizing is succesvol afgerond
message	String	Een gedetailleerde beschrijving van de status
date_initiated	Datetime	Datum en tijdstip waarop de verhuizing is aangevraagd UTC tijdzone in RFC 3339
date_last_updated	Datetime	Datum en tijdstip waarop de status voor het laatst is gewijzigd UTC tijdzone in RFC 3339
available_actions	Array	Beschikbare acties voor de verhuizing
estimated_completion	Object	Object met de informatie over de verwachte verhuisdatum: date_earliest: Datum/tijd van het eerste mogelijke moment waarop de domeinnaam automatisch verhuisd kan worden date_latest: Datum/tijd van het laatste mogelijke moment waarop de domeinnaam automatisch verhuisd kan worden Dit object is alleen beschikbaar als er informatie beschikbaar is over de verwachte verhuisdatum
initiated_via	Object	Extra informatie over de aanvraag van de verhuizing. Wordt alleen voor verhuizingen aangevraagd na 17 juni 2025. interface Via welke interface de verhuizing is aangevraagd: web: Webinterface api-v1: API V1 api-v2: API V2 system: Actie door het systeem gestart support: Actie uitgevoerd door NextName Support subuser String met de identifier van de subuser, alleen bij interface web en indien er met een subuser werd ingelogd api_key_prefix String met de prefix van de gebruikte API-key, alleen bij interface api-v2
status_history	Object	Extra informatie over alle status updates van de verhuizing status pending: De verhuizing is in behandeling failed: De verhuizing is mislukt en is niet langer actief completed: De verhuizing is succesvol afgerond status_date Datum en tijdstip waarop de status werd bijgewerkt UTC tijdzone in RFC 3339 message String met de beschrijving initiated_via Object met informatie over wie de aanvraag heeft uitgevoerd, alleen beschikbaar bij geannuleerde verhuizingen.
configuration	Object	Extra informatie over de opgegeven configuratie bij de aanvraag van de verhuizing
Object: pagination
current_page	Integer	Huidige pagina
per_page	Integer	Aantal resultaten per pagina
total_pages	Integer	Totaal aantal pagina's
total_results	Integer	Totaal aantal resultaten

Voorbeeld

Beschrijving:
Haal de details van een domeinnaam op

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/transfers/somedomainname.com";
$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/transfers/testdomeinnaam.be

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "transfer_id": "b7d464c61e82eb79",
  "domain_name": "somedomainname.com",
  "transfer_type": "standard",
  "direction": "inbound",
  "status": "pending",
  "message": "Transfer waiting for Losing Registrar Approval",
  "date_initiated": "2025-07-01T16:03:06Z",
  "date_last_updated": "2025-07-01T16:03:06Z",
  "available_actions": [
    "cancel"
  ],
  "estimated_completion": {
    "date_earliest": "2025-07-07T04:00:00Z",
    "date_latest": "2025-07-07T07:00:00Z"
  },
  "initiated_via": {
    "interface": "api-v2",
    "api_key_prefix": "abcdef"
  }
  "status_history": [
    {
      "status": "pending",
      "status_date": "2025-07-02T15:42:31Z",
      "message": "2025-07-01T16:03:06Z"
    }
  ],
  "configuration": {
    "contacts": [
      {
        "type": "admin",
	"handle": "AARP-0003",
	"internal_contact_id": "3e9d5c81a2a45016"
      },
      {
        "type": "tech",
	"handle": "AARP-0002"",
	"internal_contact_id": "aef445c51f74b332"
      }
    ],
    "auto_renewal": true
  }
},