v1

latestSwagger 2.02026-08-041113661.2 MB

DomainService

Create domain

post/v1beta/domains

Request body

accept_eap_feenumber double

accept_premium_feenumber double

admin_handlestring

application_modestring

When new gTLD is started it gets through several phases before it becomes available for registration to everybody (General availability or GA). There are several phases before GA when it is still possible to apply for a domain, but with some restrictions.

application_notice_idstring

application_smdstring

auth_codestring

autorenewstring

billing_handlestring

commentsstring

is_dnssec_enabledboolean

is_easy_dmarc_enabledboolean

is_private_whois_enabledboolean

is_sectigo_dns_enabledboolean

is_spamexperts_enabledboolean

ns_groupstring

ns_template_idinteger

ns_template_namestring

owner_handlestring

periodinteger

promo_codestring

providerstring

reseller_handlestring

tech_handlestring

unitstring

use_domicileboolean

Example request

{
  "accept_eap_fee": 0,
  "accept_premium_fee": 0,
  "additional_data": {
    "abogado_acceptance": "",
    "admin_sing_pass_id": "",
    "ae_acceptance": "1",
    "allocation_token": "",
    "auth_code": "",
    "bank_acceptance": "",
    "company_registration_number": "XX123456789X01",
    "coop_acceptance": "1",
    "customer_uin": "374892173498127349",
    "customer_uin_doc_type": {
      "description": "Singapore Personal Access ID",
      "doc_type": "singpass"
    },
    "domain_name_variants": [
      "xn--домен.cat"
    ],
    "eligibility_type": "",
    "eligibility_type_relationship": "",
    "es_annex_acceptance": "1",
    "ftld_token": "",
    "gay_donation_acceptance": "1",
    "gay_rights_protection_acceptance": "1",
    "id_number": "123456789X",
    "id_type": "",
    "idn_script": "SPA",
    "insurance_acceptance": "",
    "intended_use": "generic",
    "law_acceptance": "",
    "legal_type": "Individual",
    "maintainer": "",
    "membership_id": "A",
    "mobile_phone_number_verification": "",
    "ngo_ong_eligibility_acceptance": "",
    "ngo_ong_policy_acceptance": "",
    "passport_number": "X123456",
    "rurf_blocked_domains": "",
    "self_service": "1",
    "trademark": "1",
    "trademark_id": "",
    "travel_acceptance": "1",
    "vat": "11843009X",
    "verification_code": "",
    "vote_acceptance": "",
    "voto_acceptance": ""
  },
  "admin_handle": "XX123456-XX",
  "application_mode": "preregistration",
  "application_notice_id": "983bdc1a0000100000188801724",
  "application_smd": "",
  "auth_code": "",
  "autorenew": "on",
  "billing_handle": "XX123456-XX",
  "comments": "any comment here",
  "dnssec_keys": [
    {
      "alg": 8,
      "flags": 257,
      "protocol": 3,
      "pub_key": "WSgigdu8545g96",
      "readonly": 1
    }
  ],
  "domain": {
    "extension": "london",
    "name": "test4"
  },
  "is_dnssec_enabled": false,
  "is_easy_dmarc_enabled": false,
  "is_private_whois_enabled": false,
  "is_sectigo_dns_enabled": false,
  "is_spamexperts_enabled": false,
  "name_servers": [
    {
      "ip": "12.3.123.121",
      "ip6": "1s23:123:123:f",
      "name": "ns1.example.com",
      "seq_nr": 1
    }
  ],
  "ns_group": "example",
  "ns_template_id": 14977,
  "ns_template_name": "Default",
  "owner_handle": "XX123456-XX",
  "period": 1,
  "promo_code": "PROMOCODE",
  "provider": "SEDO",
  "reseller_handle": "XX123456-XX",
  "tech_handle": "XX123456-XX",
  "unit": "y",
  "use_domicile": false
}

Response

A successful response.

codeinteger

descstring

maintenanceboolean

Example response

{
  "code": 0,
  "data": {
    "activation_date": "2019-04-29 17:15:19",
    "additional_data": {
      "abogado_acceptance": "",
      "admin_sing_pass_id": "",
      "ae_acceptance": "1",
      "allocation_token": "",
      "auth_code": "",
      "bank_acceptance": "",
      "company_registration_number": "XX123456789X01",
      "coop_acceptance": "1",
      "customer_uin": "374892173498127349",
      "customer_uin_doc_type": {
        "description": "Singapore Personal Access ID",
        "doc_type": "singpass"
      },
      "domain_name_variants": [
        "xn--домен.cat"
      ],
      "eligibility_type": "",
      "eligibility_type_relationship": "",
      "es_annex_acceptance": "1",
      "ftld_token": "",
      "gay_donation_acceptance": "1",
      "gay_rights_protection_acceptance": "1",
      "id_number": "123456789X",
      "id_type": "",
      "idn_script": "SPA",
      "insurance_acceptance": "",
      "intended_use": "generic",
      "law_acceptance": "",
      "legal_type": "Individual",
      "maintainer": "",
      "membership_id": "A",
      "mobile_phone_number_verification": "",
      "ngo_ong_eligibility_acceptance": "",
      "ngo_ong_policy_acceptance": "",
      "passport_number": "X123456",
      "rurf_blocked_domains": "",
      "self_service": "1",
      "trademark": "1",
      "trademark_id": "",
      "travel_acceptance": "1",
      "vat": "11843009X",
      "verification_code": "",
      "vote_acceptance": "",
      "voto_acceptance": ""
    },
    "auth_code": "12345678",
    "expiration_date": "2020-04-29 17:15:19",
    "id": 123456789,
    "renewal_date": "2020-04-29 17:15:19",
    "status": "ACT"
  },
  "desc": ""
}