Transfers : List

Aangemaakt : 16-07-2025
Laatste update: -

Omschrijving

Haal lijst op met alle verhuizingen uit het account

Endpoint

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

URL parameters

Bekijk voor meer informatie over de mogelijke zoekwaarden en de pagina: Zoekopdrachten

Parameter	Datatype	Omschrijving
transfer_id	String	Zoekwaarde voor de unieke ID van de verhuizing
domain_name	String	Zoekwaarde voor de domeinnaam
transfer_type	Array	Zoekwaarde voor het type verhuizing, mogelijk waarden: standard, internal, registry_action, bulk_operation, transfer_service
status	Array	Zoekwaarde voor status van de verhuizing, mogelijke waarden: failed, pending, completed
direction	Array	Zoekwaarde voor richting van de verhuizing, mogelijke waarden: inbound, outbound
message	String	Zoekwaarde voor de gedetailleerde beschrijving van de verhuizing
date_initiated	String	Zoekwaarde voor de datum waarop de verhuizing werd gestart, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone in RFC 3339
date_last_updated	String	Zoekwaarde voor de datum waarop de status voor het laatst werd gewijzigd, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone in RFC 3339
initiated_via_interface	Array	Zoekwaarde voor interface van verwijdering, mogelijke waarden: web, api-v1, api-v2, system, support
initiated_via_user	String	Zoekwaarde voor user of api-key-prefix van die de verhuizing heeft aangevraagd

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
Array: data[] met object:
transfer_id	String	Unieke ID voor de verhuizing
domain_name	String	Domeinnaam
transfer_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
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

Beschrijving:
Haal lijst met verhuizingen op

PHP
cURL

Opdracht in PHP:

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

Antwoord:

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

{
  "data": [
    {
      "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"
      }
    },
    {
      "transfer_id": "2f8a3d9c6e741b0f",
      "domain_name": "somedomainname.nl",
      "transfer_type": "standard",
      "direction": "inbound",
      "status": "completed",
      "message": "Transferred",
      "date_initiated": "2025-07-02T13:04:06Z",
      "date_last_updated": "2025-07-02T13:04:06Z",
      "available_actions": [],
      "initiated_via": {
        "interface": "web",
      }
    },
    {
      "transfer_id": "4c7e92a5b8f31d46",
      "domain_name": "someotherdomainname.com",
      "transfer_type": "standard",
      "direction": "inbound",
      "status": "failed",
      "message": "Client rejected transfer",
      "date_initiated": "2025-07-04T10:58:03Z",
      "date_last_updated": "2025-07-06T18:23:12Z",
      "available_actions": [],
      "initiated_via": {
        "interface": "web",
        "subuser": "9d5b27f4a8c63e10",
      }
    },
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 3
  }
}

Beschrijving:
Haal een lijst met pending verhuizingen op

PHP
cURL