CentralNic Reseller Homepage
CentralNic Reseller Homepage

.us

API commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

Domain Registration

(API Command reference » AddDomain)
Exception
command               = AddDomain
domain                = yourdomain.us
ownercontact0         = (CONTACT)
admincontact0         = (CONTACT)
techcontact0          = (CONTACT)
billingcontact0       = (CONTACT)
nameserver0           = (nameserver1)
nameserver1           = (nameserver2)
x-us-nexus-apppurpose = P1|P2|P3|P4|P5
x-us-nexus-category   = C11|C12|C21|C31|C32
x-us-nexus-validator  = CC (only needed, if x-us-nexus-category equals C31 or C32)

Domain Modification

(API Command reference » ModifyDomain)
Command
command = ModifyDomain
domain  = yourdomain.us

Domain Renewal

(API Command reference » RenewDomain)
Command
command    = RenewDomain
domain     = yourdomain.us
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)
Command
COMMAND = DeleteDomain
DOMAIN = yourdomain.us

Domain Transfer

(API Command reference » TransferDomain)
Command
command = TransferDomain
domain = yourdomain.us
action = REQUEST
auth = (TEXT)
  • A .us domain transfer must be initiated with a so-called authorisation code, which can be obtained from the current registrar through the owner or Admin-C of the domain.
  • Please ensure, that you have a correct authorisation code associated with the domain, before initiating the transfer, otherwise it will fail.
  • Ensure that your respective domain does not have a lock-status (REGISTRAR-LOCK or HOLD). This can be seen in the WHOIS. If the domain is locked, then the owner can demand that this be unlocked.
  • Initiate the transfer on time and not just shortly before the domain expires.
  • Please ensure that the domain is older than 60 days otherwise the transfer will be denied.

Domain Restore

(API Command reference » RestoreDomain)
Command
command = RestoreDomain
domain  = yourdomain.us

Domain Extensions

X-US-NEXUS-APPPURPOSEP1 - Business use for profit
P2 - Non-profit business, club, association, religious organization, etc.
P3 - Personal use
P4 - Education purposes
P5 - Government purposes
X-US-NEXUS-CATEGORYA natural person,
C11 - Who is a United States citizen.
C12 - Who is a permanent resident of the United States of America or any of its posessions or territories.
A U.S. Organization incorporated within one of the fifty (50) U.S. States, the District of Columbia, or any of the U.S. Possessions or territories or organized or otherwise constituted under the laws of a state of the United States of America, the District of Columbia or any of its possessions or territories or a U.S. Federal, state, or local government entity or a political subdivision thereof.
C21 - U.S. Organization incorporated within one of the 50 states or a U.S. Territory
An entity or organization that has a bona fide presence in the United States of America or any of its possessions or territories.
C31 - Regularly engages in lawful activities (sales of goods or services or other business, commercial or non-commercial, including not-for-profit relations in the United States).
C32 - Entity has an office or other facility in the US.
X-US-NEXUS-VALIDATORSpecify the two-letter country-code of the registrant (if Nexus Category is either C31 or C32).

Domain Restrictions

A .US Domain can only be registered by any U.S. citizen or resident, as well as any business or organization, including federal, state, and local government with a bona fide presence in the United States.
One of the following eligibility requirements must be met:

  • A natural person
    • who is a citizen or permanent resident of the United States of America or any of its possessions or territories or
    • whose primary place of domicile is in the United States of America or any of its possessions, or
  • Any entity or organization that is
    • incorporated within one of the fifty (50) U.S. states, the District of Columbia, or any of the United States possessions or territories or
    • organized or otherwise constituted under the laws of a state of the United States of America, the District of Columbia, or any of its possessions or territories, or
  • An entity or organization (including federal, state, or local government of the United States, or a political subdivision thereof) that has a bona fide presence in the United States. See Section B.3.1 of the NeuStar proposal to the Department of Commerce for details concerning what constitutes a "bona fide presence".

For further information check the .US Nexus Requirements Policy.

Supported IDN Scripts

The following IDN scripts are supported by .us.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.

ArabicAR
ChineseZH
DanishDA
Dutch FlemishNL
FrenchFR
GermanDE
ItalianIT
JapaneseJA
KoreanKO
PolishPL
SpanishES
SwedishSV

Get more information of "IDN tables", which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.

We reallydomains
-