Register

Note

It is recommended, that you read TLD and their Contacts specific information, prior to continuing reading further:

Description

Registers a domain name.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
domain-name String Required

Domain name that you need to Register.

For an Internationalized Domain Name, refer to the supported character sets mentioned below:

Note

The domain name used in the API call can be in Unicode (the native language) or in Punycode format.

Example: The domain name can be provided as ѯҋ111 (Unicode) or xn--111-dkd4l (Punycode).

domain-name=ѯҋ111 domain-name=xn--111-dkd4l
years Integer Required Number of years for which you wish to Register this domain name.
ns Array of Strings Required The Name Servers of the domain name.
customer-id Integer Required The Customer for whom you wish to Register this domain name.
reg-contact-id Integer Required The Registrant Contact of the domain name.
admin-contact-id Integer Required

The Administrative Contact of the domain name.

Note

Pass -1 for the following TLDs:

tech-contact-id Integer Required

The Technical Contact of the domain name.

Note

Pass -1 for the following TLDs:

billing-contact-id Integer Required

The Billing Contact of the domain name.

Note

Pass -1 for the following TLDs:

  • .LONDON

invoice-option String Required This will decide how the Customer Invoice will be handled. Set any of below mentioned Invoice Options for your Customer:
  • NoInvoice: This will not raise any Invoice. The Order will be executed.

  • PayInvoice: This will raise an Invoice and:

    • if there are sufficient funds in the Customer's Debit Account, then the Invoice will be paid and the Order will be executed.

    • if there are insufficient funds in the Customer's Debit Account, then the Order will remain pending in the system.

  • KeepInvoice: This will raise an Invoice for the Customer to pay later. The Order will be executed.

  • OnlyAdd: This will raise an Invoice for the Customer to pay later. The registration action request will remain pending.

purchase-privacy Boolean optional

Adds the Privacy Protection service for the domain name.

Privacy Protection is not supported for the following TLDs (extensions):

  • .ORG.CO, .MIL.CO, .GOV.CO, .EDU.CO

  • .TEL

protect-privacy Boolean Optional

Enables / Disables the Privacy Protection setting for the domain name.

attr-name Map[name] Optional Mapping key of the extra details needed to register a domain name. Refer the description of attr-value.
attr-value Map[value] Optional

Mapping value of the extra details required to register a domain name. This together with attr-name shall contain the extra details.

  • To register an Internationalized Domain Name:

    idnLanguageCode: While registering an IDN, you need to provide the corresponding language code:

    • .BIZ IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

      • Chinese - zh

      • Danish - da

      • Finnish - fi

      • German - de

      • Hungarian - hu

      • Icelandic - is

      • Japanese - jp

      • Korean - ko

      • Lithuanian - lt

      • Latvian - lv

      • Norwegian - no

      • Polish - pl

      • Portuguese - pt

      • Spanish - es

      • Swedish - sv

      attr-name1=idnLanguageCode&attr-value1=ko
    • .CO IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

      • Chinese - zh

      • Danish - da

      • Finnish - fi

      • Icelandic - is

      • Japanese - jp

      • Korean - ko

      • Norwegian - no

      • Spanish - es

      • Swedish - sv

      attr-name1=idnLanguageCode&attr-value1=da
    • .COM / .NET IDN: The language code depends upon the language whose characters are used in the domain name. You can refer to the list of languages supported and the corresponding language code.

      attr-name1=idnLanguageCode&attr-value1=aze
    • .INFO IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

      • Danish - da

      • German - de

      • Hungarian - hu

      • Icelandic - is

      • Korean - ko

      • Latvian - lv

      • Lithuanian - lt

      • Polish - pl

      • Spanish - es

      • Swedish - sv

      attr-name1=idnLanguageCode&attr-value1=ko
    • .ORG IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

      • Chinese - zh-cn (for IDN.org domain name and .机构 domain name - the Chinese IDN for .org)

      • Cyrillic - ru (for .орг domain name - the Russian IDN for .org)

      • Danish - da

      • German - de

      • Hindi - hin-deva (for .संगठन domain name - the Hindi IDN for .org)

      • Hungarian - hu

      • Icelandic - is

      • Korean - ko

      • Latvian - lv

      • Lithuanian - lt

      • Polish - pl

      • Spanish - es

      • Swedish - sv

      attr-name1=idnLanguageCode&attr-value1=ko
    • .TEL IDN: The language code depends upon the language whose characters are used in the domain name. Supported languages and the corresponding language codes are:

      • Chinese - zh

      • Danish - da

      • French - fr

      • Finnish - fi

      • German - de

      • Hungarian - hu

      • Icelandic - is

      • Japanese - jp

      • Korean - ko

      • Latvian - lv

      • Lithuanian - lt

      • Norwegian - no

      • Polish - pl

      • Portuguese - pt

      • Russian - ru

      • Spanish - es

      • Swedish - sv

      attr-name1=idnLanguageCode&attr-value1=ko
  • To register a Domain Name in the Sunrise Phase:

    • phase: Mention the phase as sunrise.

      attr-name1=phase&attr-value1=sunrise
    • smd: Pass the content of the smd file as the value for this attr-name.

      attr-name2=smd&attr-value2=<smd_file_content>
  • To register a Domain Name in the Pre-Registration Phase:

    phase: Mention the phase as

    • prega for regular pre-registration

      attr-name1=phase&attr-value1=prega
    • landrush for priority pre-registration

      attr-name1=phase&attr-value1=landrush
  • To register a domain name that has a Trademark Claim:

    tm-claim: Mention the value for this additional parameter as accepted.

    attr-name1=tm-claim&attr-value1=accepted
  • To register a .TEL domain name:

    • whois-type: This parameter indicates whether the Registrant is an Individual or an Oragnization. The value needs to be passed as either Natural (for Individual) or Legal (for Oragnization).

      attr-name1=whois-type&attr-value1=Legal
    • publish: This parameter indicates whether the Contact Details associated with a .TEL domain name need to be published or excluded from the publicly available Whois database. The value needs to be passed as either Y or N.

      This parameter is required if whois-type parameter is Natural, otherwise is it Optional.

      attr-name2=publish&attr-value2=Y
    Note

    You may exclude the whois-type parameter itself from the API call, since it is optional. In that case,:

    • whois-type will be automatically set to Legal,

      AND

    • you need not pass the publish parameter.

  • To register a .LAWYER, .ATTORNEY domain name:

    REGULATORY BODY: The Regulatory Body information is collected during the registration process. This information is only required if the registrant is offering professional services related to the TLD

    attr-name1=regulatorybody&attr-value1=<regulatory-body-here>
  • To register a .DEGREE, .ENGINEER, .MORTGAGE, .MARKET, .SOFTWARE, .NAVY, .VET, .ARMY, .GIVES, .AIRFORCE, .BIO, .ARCHI domain name:

    TNC: stands for Terms and Conditions

    Any other value for attr-value1 except y or Y will result in an error "Please accept the Terms & Conditions".

    attr-name1=tnc&attr-value1=y
  • To register a .DENTIST domain name:

    TNC: stands for Terms and Conditions

    Any other value for attr-value1 except y or Y will result in an error "Please accept the Terms & Conditions".

    REGULATORY BODY: The Regulatory Body information is collected during the registration process. This information is only required if the registrant is offering professional services related to the TLD

    attr-name1=tnc&attr-value1=y&attr-name2=regulatorybody&attr-value2=<regulatory-body>

HTTP Method

POST

Example Test URL Request

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=domain.com&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customer-id=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice

Example Test URL Request for Registering a Domain Name with Privacy Protection

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=domain.com&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customer-id=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice&purchase-privacy=true

Example Test URL Request for Registering a Domain Name in the Sunrise Phase

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=domains1.bike&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customerid=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice&attr-name1=phase&attr-value1=sunrise&attr-name2=smd&attr-value2=<smd_file_content>

Example Test URL Request for Registering a .COM IDN

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=ѯҋ112.com&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customer-id=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice&attr-name1=idnLanguageCode&attr-value1=aze

Example Test URL Request for Registering a .TEL Domain Name

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=domain.tel&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customer-id=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice&attr-name1=whois-type&attr-value1=Natural&attr-name2=publish&attr-value2=N

Example Test URL Request for Registry Premium domain registration

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=domain.com&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customer-id=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice &attr-name1=premium&attr-value1=true

Example Test URL Request for domain registration in EAP

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=domain.com&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customer-id=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice&attr-name1=eap&attr-value1=true

Example Test URL Request for Registry Premium domain registration in EAP

https://test.httpapi.com/api/domains/register.xml?auth-userid=0&api-key=key&domain-name=domain.com&years=1&ns=ns1.domain.com&ns=ns2.domain.com&customer-id=0&reg-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-option=KeepInvoice&attr-name1=premium&attr-value1=true&attr-name2=eap&attr-value2=true

Response

Returns a hash map containing the below details:

  • Domain Name (description)

  • Order ID of the Domain Registration Order (entityid)

  • Action Type (actiontype)

  • Description of the Domain Registration Action (actiontypedesc)

  • Action ID of the Domain Registration Action (eaqid)

  • Domain Registration Action Status (actionstatus)

  • Description of the Domain Registration Action Status (actionstatusdesc)

  • Invoice ID of the Domain Registration Invoice (invoiceid)

  • Selling Currency of the Reseller (sellingcurrencysymbol)

  • Transaction Amount in the Selling Currency (sellingamount)

  • Unutilized Transaction Amount in the Selling Currency (unutilisedsellingamount)

  • Customer ID associated with the Domain Registration Order (customerid)

  • Privacy Protection Details (privacydetails)

    • Domain Name (description)

    • Order ID of the Domain Registration Order (entityid)

    • Action Type (actiontype)

    • Description of the Privacy Protection Purchase Action (actiontypedesc)

    • Action ID of the Privacy Protection Purchase Action (eaqid)

    • Privacy Protection Purchase Action Status (actionstatus)

    • Description of the Privacy Protection Purchase Action Status (actionstatusdesc)

    • Invoice ID of the Privacy Protection Purchase Invoice (invoiceid)

    • Selling Currency of the Reseller (sellingcurrencysymbol)

    • Transaction Amount in the Selling Currency (sellingamount)

    • Unutilized Transaction Amount in the Selling Currency (unutilisedsellingamount)

    • Customer ID associated with the Domain Registration Order (customerid)

Note
  • invoiceid, sellingcurrencysymbol, sellingamount, unutilisedsellingamount and customerid will not be returned if invoice-option is set to NoInvoice.

  • Details under privacydetails will be returned only if purchase-privacy is set to true in the Domain Registration API call

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.