Updated on 22 September 2026

Register new domain during launch period

1 Description
2 Common language examples

Description

POST https://rest.netim.com/3.0/domain/{domain}/lp/

Request the registration of a domain during a launch period.

URL Parameters

  • {domain}

    Domain name to be registered.
    For IDN, you must provide the domain name as ACE string.

 

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 (12)
    ID of the owner contact (With “isOwner=1”).
  • idAdmin string (12)
    ID of the administrative contact (With “isOwner=0”).
  • idTech string (12)
    ID of the technical contact (With “isOwner=0”).
  • idBilling string (12)
    ID of the billing contact (With “isOwner=0”).
  • duration integer
    Duration (in years).
  • launchPhase string (255)
    Code of the launch period.
  • nameservers array (0-13)
    Nameserver list

 

JSON example

{
    "idOwner": "HOLDER_ID",
    "idAdmin": "CONTACT_ID",
    "idTech": "CONTACT_ID",
    "idBilling": "CONTACT_ID",
    "nameservers": {
        "1": {
            "name": "ns1.netim.net"
        },
        "2": {
            "name": "ns2.netim.net"
        }
    },
    "duration": 1,
    "launchPhase": "LR"
}

All important information relative to the domain registration applies. See register new domain

Find out more information concerning openings/launches for the requested extension on the product pages

Once requested, you will get an operation in pending status. Netim will try to register the domain name during the corresponding phase.

launchPhase codes:

SR : Sunrise Period
LR1: Landrush Period 1
LR2: Landrush Period 2
LR3: Landrush Period 3
GA : General availability

Common language  examples

<?php

$ch = curl_init();

$body = array(
    'idOwner' => 'HOLDER_ID',
    'idAdmin' => 'CONTACT_ID',
    'idTech' => 'CONTACT_ID',
    'idBilling' => 'CONTACT_ID',
    'nameservers' => array(
        1 => ['name' => 'ns1.netim.net'],
        2 => ['name' => 'ns2.netim.net'],
    ),
    'duration' => 1,
    'launchPhase' => 'LR'
);

curl_setopt($ch, CURLOPT_URL, "https://rest.netim.com/3.0/domain/$domain/lp/");
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\",\"nameservers\":{\"1\":{\"name\":\"ns1.netim.net\"},\"2\":{\"name\":\"ns2.netim.net\"}},\"duration\":1,\"launchPhase\":\"LR\"}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://rest.netim.com/3.0/domain/" + domain + "/lp/"))
            .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/3.0/domain/' + domain + '/lp/'
sessionId = "1234567"

data = {
    "idOwner": "HOLDER_ID",
    "idAdmin": "CONTACT_ID",
    "idTech": "CONTACT_ID",
    "idBilling": "CONTACT_ID",
    "nameservers": {
        "1": {
            "name": "ns1.netim.net"
        },
        "2": {
            "name": "ns2.netim.net"
        }
    },
    "duration": 1,
    "launchPhase": "LR"
}

headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}

response = requests.post(url, headers=headers, data=json.dumps(data))
curl -X POST https://api.netim.com/rest/3.0/domain/example.com/lp/ \
-H 'Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' \
-H 'content-type: application/json' \
-d '{"idOwner":"HOLDER_ID","idAdmin":"CONTACT_ID","idTech":"CONTACT_ID","idBilling":"CONTACT_ID","nameservers":{"1":{"name":"ns1.netim.net"},"2":{"name":"ns2.netim.net"}},"duration":1,"launchPhase":"LR"}'