Account : Removed domains

Aangemaakt : 16-07-2025
Laatste update: -

Omschrijving

Haal een lijst op met alle verwijderde domeinnamen uit het account

De uitgebreide informatie removal_reason, removal_sub_reason en removed_via zijn beschikbaar voor verwijderde domeinnamen vanaf 01-06-2025

Endpoint

GET https://api.nextname.nl/v2/account/removed-domains

Parameters

Parameter	Datatype	Omschrijving
domain_name	String	Zoekwaarde voor verwijderde domeinnaam
date_removed	Datetime	Zoekwaarde voor datum van verwijdering
removal_reason	Array	Zoekwaarde voor reden van verwijdering Mogelijke waarden: transferred_out, deleted
removal_sub_reason	Array	Zoekwaarde voor subreden van verwijdering Mogelijke waarden: manual, auto_renewal_disabled, renewal_prohibited, insufficient_funds, registry_action, standard, internal, pushed_to_registry, bulk_operation
removed_via_interface	Array	Zoekwaarde voor interface van verwijdering Mogelijke waarden: web, api-v1, api-v2, system, support
removed_via_user	String	Zoekwaarde voor user of api-key-prefix van verwijdering
removed_via_comments	String	Zoekwaarde voor extra informatie over de verwijdering

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
Array: data[] met object:
domain_name	String	De verwijderde domeinnaam
date_removed	Datetime	Datum en tijdstip waarop de domeinnaam uit het account werd verwijderd UTC tijdzone in RFC 3339
removal_reason	String	De reden van de verwijdering van de domeinnaam uit het account: transferred_out De domeinnaam werd naar een andere registrar verhuisd deleted De domeinnaam werd opgeheven
removal_sub_reason	String	De subreden van de verwijdering van de domeinnaam uit het account: Mogelijke waarden voor reason transferred_out: standard De domeinnaam werd via een normale verhuizing naar een andere registrar verhuisd internal De domeinnaam werd naar een ander account bij NextName verhuisd registry_action De domeinnaam werd in opdracht van de registry naar een andere registrar verhuisd pushed_to_registry De domeinnaam werd naar het beheer van de registry gepusht bulk_operation De domeinnaam werd via een bulk verhuizing naar een andere registrar verhuisd Mogelijke waarden voor reason deleted: manual De domeinnaam werd handmatig opgeheven auto_renewal_disabled De domeinnaam werd niet verlengd nadat de automatisch verlengen werd uitgeschakeld renewal_prohibited De domeinnaam werd niet verlengd omdat verlenging niet was toegestaan. Dit kan bijvoorbeeld een door de registry opgelegde beperking zijn insufficient_funds De domeinnaam werd niet verlengd omdat het saldo op het account ontoereikend was op het moment van verlenging registry_action De domeinnaam werd opgeheven door de registry
removed_via	Object	Extra informatie over de verwijdering. Wordt alleen getoond indien er extra informatie beschikbaar is over de verwijdering. interface Via welke interface de verwijdering 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 comments String met extra informatie over de verwijdering, alleen getoond indien beschikbaar

Voorbeeld

Beschrijving:
Haal de uit het account verwijderde domeinnamen op

PHP
cURL

Opdracht in PHP:

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

Antwoord:

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

{
  "data": [
    {
      "domain_name": "somedomainname.nl",
      "date_removed": "2025-06-02T22:53:01Z",
      "removal_reason": "deleted",
      "removal_sub_reason": "manual",
      "removed_via": {
        "interface": "api-v2",
	"api_key_prefix": "ZeXij44s"
      }
    },
    {
      "domain_name": "somedomainname.eu",
      "date_removed": "2025-06-02T22:54:04Z",
      "removal_reason": "deleted",
      "removal_sub_reason": "auto_renewal_disabled",
      "removed_via": {
	"interface": "api-v1"
      }
    },
    {
      "domain_name": "someotherdomainname.blog",
      "date_removed": "2025-06-12T09:38:05Z",
      "removal_reason": "transferred_out",
      "removal_sub_reason": "standard",
      "removed_via": {
        "interface": "system"
      }	
    },
    {
      "domain_name": "someotherdomainname.com",
      "date_removed": "2025-06-15T12:43:55Z",
      "removal_reason": "deleted",
      "removal_sub_reason": "registry_action",
      "removed_via": {
        "interface": "system",
	"comments": "Registration did not need general terms, case #AAA-001"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 4
  }
}