Updated on 20 September 2023

Transfer and Trade domain name

Description

POST https://rest.netim.com/1.0/domain/{domain}/transfer-trade/

Request the transfer of a domain name to Netim with a change of the registrant

URL Parameters

  • {domain}
    Domain name to be transfered.

Headers

  • Authorization string

    The Autorization header must start with “Bearer ” followed by the session ID.
    Example:”Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26″

  • Content-type string

    Content type of the request

    Only “application/json” is accepted

Body

REQUIRED

  • idOwner string (8)
    ID of the owner contact (With “isOwner=1”).
  • idAdmin string (8)
    ID of the administrative contact (With “isOwner=0”).
  • idTech string (8)
    ID of the technical contact (With “isOwner=0”).
  • idBilling string (8)
    ID of the billing contact (With “isOwner=0”).

OPTIONAL

  • authID string (8)
    Autorisation code / EPP code (If applicable).
  • ns1 string (255)
    Primary name server.
  • ns2 string (255)
    Secondary name server.
  • ns3 string (255)
    Secondary name server.
  • ns4 string (255)
    Secondary name server.
  • ns5 string (255)
    Secondary name server.

JSON example

{
    "idOwner":"HOLDER_ID", 
    "idAdmin":"CONTACT_ID", 
    "idTech":"CONTACT_ID", 
    "idBilling":"CONTACT_ID", 
    "ns1":"ns1.netim.net", 
    "ns2":"ns2.netim.net", 
    "ns3":"ns3.netim.net"
}
  • Contact IDs must exist and belong the reseller.
  • idOwner must be a contact with isOwner=1
  • idAdmin, idTech, idBilling must be contacts with isOwner=0 or be defined with the reseller ID
  • According to the extension, allocation and semantic rules may apply. See relative information for the extension
  • The minimal number of nameservers must match the requirements of the extension.
  • A DNS test may be performed prior the registration. See structdomaintldinfo.HasZonecheck

Common language examples

<?php
 
	$ch = curl_init();
 
	$body = array(
		"idOwner" => "HOLDER_ID",
		"idAdmin" => "CONTACT_ID",
		"idTech" => "CONTACT_ID",
		"idBilling" => "CONTACT_ID",
		"ns1" => "ns1.netim.net",
		"ns2" => "ns2.netim.net",
		"ns3" => "ns3.netim.net",
	);
 
	curl_setopt($ch, CURLOPT_URL,"https://rest.netim.com/1.0/domain/$domain/transfer-trade/");
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
	curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $sessionID", "Content-type: application/json"]);
	curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
	curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
 
	$result = json_decode(curl_exec ($ch), true);
	$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
	curl_close ($ch);
 
import java.util.Base64;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class Example {
 
	public static void main(String args[]) throws Exception {
		String sessionID = "12345678";
		String domain = "example.com";
 
		String body = "{\"idOwner\":\"HOLDER_ID\",\"idAdmin\":\"CONTACT_ID\",\"idTech\":\"CONTACT_ID\",\"idBilling\":\"CONTACT_ID\",\"ns1\":\"ns1.netim.net\",\"ns2\":\"ns2.netim.net\",\"ns3\":\"ns3.netim.net\"}";
 
		HttpClient client = HttpClient.newHttpClient();
		HttpRequest request = HttpRequest.newBuilder()
			.uri(URI.create("https://rest.netim.com/1.0/domain/" + domain + "/tranfser-trade/"))
			.method("POST", HttpRequest.BodyPublishers.ofString(body))
			.header("Content-Type", "application/json")
			.header("Accept-Language", "EN")
			.header("Authorization", "Bearer " + sessionID)
			.build();
		HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
		String result = response.body().toString();
	}
}
#!/usr/bin/python3
 
import json
import requests
 
domain = 'example.com'
 
url = 'https://rest.netim.com/1.0/domain/' + domain + '/transfer-trade/'
 
sessionId = "1234567"
 
data = {
    "idOwner":"HOLDER_ID",
    "idAdmin":"CONTACT_ID",
    "idTech":"CONTACT_ID",
    "idBilling":"CONTACT_ID",
    "ns1":"ns1.netim.net",
    "ns2":"ns2.netim.net",
    "ns3":"ns3.netim.net",
}
 
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
 
 
response = requests.post(url, headers=headers, data=json.dumps(data))
curl -X POST https://rest.netim.com/1.0/domain/example.com/transfer-trade/ \
-H 'Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' \
-H 'content-type: application/json' \
-d '{"idAdmin":"HOLDER_ID","idAdmin":"CONTACT_ID","idTech":"CONTACT_ID","idBilling":"CONTACT_ID","ns1":"ns1.netim.net","ns2":"ns2.netim.net","ns3":"ns3.netim.net"}'