.us
API Commands
Section titled “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
Section titled “Domain Registration”(API Command reference » AddDomain)
command = AddDomaindomain = yourdomain.usownercontact0 = (CONTACT)admincontact0 = (CONTACT)techcontact0 = (CONTACT)billingcontact0 = (CONTACT)nameserver0 = (nameserver1)nameserver1 = (nameserver2)x-us-nexus-apppurpose = P1|P2|P3|P4|P5x-us-nexus-category = C11|C12|C21|C31|C32x-us-nexus-validator = CC (only needed, if x-us-nexus-category equals C31 or C32)Domain Modification
Section titled “Domain Modification”(API Command reference » ModifyDomain)
command = ModifyDomaindomain = yourdomain.usDomain Renewal
Section titled “Domain Renewal”(API Command reference » RenewDomain)
command = RenewDomaindomain = yourdomain.usperiod = (INT)expiration = (INT)Domain Deletion
Section titled “Domain Deletion”(API Command reference » DeleteDomain)
COMMAND = DeleteDomainDOMAIN = yourdomain.usDomain Transfer
Section titled “Domain Transfer”(API Command reference » TransferDomain)
command = TransferDomaindomain = yourdomain.usaction = REQUESTauth = (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.
- To confirm the transfer, we sent out an email to the Registrant which needs to be confirmed accordingly.
Domain Restore
Section titled “Domain Restore”(API Command reference » RestoreDomain)
command = RestoreDomaindomain = yourdomain.usDomain Extensions
Section titled “Domain Extensions”| X-US-NEXUS-APPPURPOSE | P1 - 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-CATEGORY | A 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-VALIDATOR | Specify the two-letter country-code of the registrant (if Nexus Category is either C31 or C32). |
Domain Restrictions
Section titled “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
Section titled “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.
| Arabic | AR |
|---|---|
| Chinese | ZH |
| Danish | DA |
| Dutch Flemish | NL |
| French | FR |
| German | DE |
| Italian | IT |
| Japanese | JA |
| Korean | KO |
| Polish | PL |
| Spanish | ES |
| Swedish | SV |
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.
