Contacts : Details

Aangemaakt : 01-03-2023
Laatste update: -

Omschrijving

Haal informatie op van een specifieke contact handle

Endpoint

GET https://api.nextname.nl/v2/contacts/handle

URL parameters

Bij dit commando worden geen extra parameters opgegeven

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
handle	String	Handle van het contact
company_name	String	Bedrijfsnaam van het contact
name	String	Naam van het contact
address_1	String	Adresregel 1 van het contact
address_2	String	Adresregel 2 van het contact
postal_code	String	Postcode van het contact
city	String	Plaatsnaam van het contact
state	String	Staat/provincie van het contact
country	String	Land van het contact, 2-Letterige landcode volgens ISO_3166-1 voor zoeken op land
phone	String	Telefoonnummer van het contact, e164a formaat
email	String	E-mailadres van het contact
connections	Integer	Aantal connecties met domeinnamen
connections_details	Object	Object met details van de connecties, mogelijke waarden: registrant: Aantal registrant connecties admin: Aantal admin connecties tech: Aantal tech connecties billing: Aantal billing connecties
date_created	Datetime	Datum en tijdstip waarop het contact werd aangemaakt in UTC tijdzone in RFC 3339
date_last_updated	Datetime	Datum en tijdstip waarop het contact voor het laatst werd gewijzigd in UTC tijdzone in RFC 3339
auto_delete	Boolean	Of het contact automatisch wordt opgeruimd indien er geen connecties (meer) zijn
status	Array	Status van het contact: ok: Het contact is actief pending_update: Er is een update in behandeling pending_validation: Er is een validatie in behandeling
tlddata	Object	JSON object met alle opgegeven TLD specifieke parameters, zie ook: Extra parameters voor contacten
validations	Array	Array met alle validatities, alle elementen zijn als volgt opgebouwd: registry: De registry waarvoor de validatie is uitgevoerd version: De versie van de validatie

Voorbeeld

Beschrijving:
Haal informatie van een contact op

PHP
cURL

Opdracht in PHP:

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

Antwoord:

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

{
  "handle": "AARP-0002",
  "company_name": "Bedrijf BV",
  "name": "P Jansen",
  "address_1": "Kerkstraat 1",
  "address_2": "app 2",
  "postal_code": "1234 AB",
  "city": "Almere",
  "state": "Flevoland",
  "country": "NL",
  "phone": "+31.612345678",
  "email": "info@nextname.nl",
  "connections": 12,
  "connections_details": {
    "registrant": 6,
    "admin": 3,
    "tech": 2, 
    "billing": 1
  },
  "date_created": "2020-05-26T08:44:53Z",
  "date_last_updated": "2021-03-13T12:48:12Z",
  "auto_delete": true,
  "status": [
    "ok","pending_validation"
   ],
   "tlddata": {
     "SIDN": {
     "legal_form": "BV",  
     "coc_number": "12345678"
   }
 },
 "validations": [
   {
     "registry": "General",
     "version": "V1"
   }
 ]
}