Latest revision as of 15:22, 15 November 2013

PUT /accounts/{accountId}/domains/{domainName}

Place a domain registration order for an existing account.

Request

PUT /accounts/{accountId}/domains/{domainName}

URI Parameters

accountId - string

The account number

domainName - string

The domain name. IE: example.com is a valid domain name, whereas http://www.example.com or www.example.com are not. If the domain name is invalid, or is otherwise not registerable such as for a non-existent or non-supported TLD, an error will be returned. Domain names are case insensitive. The domain name must be an open or suspended product under the authenticated franchise.

Request Headers

Content-Type

Required. Set this header to application/json; charset=UTF-8

Authorization

Required.

Request Body

Request Body for registering a domain

{
   "domainName": "{domainName}",
   "operation": "transfer",
   "term": {term},
   "authInfo" : "{authInfo}",
   "nameservers" : [ "{nameserver}", "{nameserver}" ],
   "additionalParams" : { 
      "usNexusCode": "{usNexusCode}", 
      "usNexusCategory": "{usNexusCategory}" 
   },
   "contactInfo" : {
      "registrant": {
         "type": "registrant",
         "firstName": "{firstName}",
         "lastName": "{lastName}",
         "company": "{company}",
         "street1": "{street1}",
         "city": "{city}",
         "zipOrPostal": "{zipOrPostal}",
         "stateOrProvince": "{stateOrProvince}",
         "countryCode": "{countryCode}",
         "email1": "{email1}",
         "phone1": "{phone1}" },
      "administrative": {
         "type": "administrative",
         ...
      },
      "billing": {
         "type": "billing",
         ...
      },
      "technical": {
         "type": "technical",
         ...
      }
   }
}
 

Request Parameters

domainName - string

The domain name

operation - string

"register" to register a domain

term - integer

the registration term (period) in years, for transfer operation value must be 1

authInfo - string

authentication info, currently not supported

nameservers - list of strings

domain name servers (DNS) for the domain

usNexusCode - string (optional) (required for .us)

one of the following [P1, P2, P3, P4, P5]

usNexusCategory - string (optional) (required for .us)

one of the following [C11, C12, C21, C31, C32]

company - string (optional)

The company or organization name

firstName - string

The first name of the contact person

lastName - string

The last name of the contact person

street1 - string

The street address

street2 - string (optional)

The second line of the street address (if any)

city - string

The city

countryCode - string

The international 2-letter country code

stateOrProvince - string

The state or province. For US states use the 2-letter state code

zipOrPostal - string

The postal code

email1 - string

The e-mail address of the contact person

phone1 - string

The phone number of the contact person in valid E.164 format, e.g. +1.3209270625

Response

Status Code

202 Accepted

The domain registration order has been submitted.

400 Bad Request

The domain information is invalid.

Response Body

Response Body for registering domain

The response contains the order id and the link for the domain registration order.

{
   "orderId": "0000013dfeb0db5aa6c51427000ac81d1e6e110e",
   "links":
      [{"href": "http://coreapi01.ote.chicago.hostway:8100/orders/0000013dfeb0db5aa6c51427000ac81d1e6e110e",
        "rel": "self"}]
}
 

Example of ordering transfer .com domain.

Request

PUT /accounts/acct839326/domains/ng-test-fitnesse-shortcut-20130412-0940.com
Content-Type: application/json; charset=UTF-8
Authorization: Basic ...

{
   "domainName": "ng-test-fitnesse-shortcut-20130412-0940.com",
   "operation": "transfer",
   "term": 1,
   "authInfo" : "mysecret",
   "nameservers" : [ "ns1.test.com", "ns2.test.com" ],
   "contactInfo" : {
      "registrant": {
         "type": "registrant",
         "firstName": "John",
         "lastName": "Doe",
         "company": "ACME Inc.",
         "street1": "123 First Str.",
         "city": "Chicago",
         "zipOrPostal": "34567",
         "stateOrProvince": "IL",
         "countryCode": "US",
         "email1": "john.doe@test.com",
         "phone1": "+1.312.456789098"
      },
      "administrative": {
         "type": "administrative",
         ...
      },
      "billing": {
         "type": "billing",
         ...
      },
      "technical": {
         "type": "technical",
         ...
      }
   }
}
 

Response

202 Accepted

{
   "orderId": "0000013dfeb0db5aa6c51427000ac81d1e6e110e",
   "links":
      [{"href": "http://coreapi01.ote.chicago.hostway:8100/orders/0000013dfeb0db5aa6c51427000ac81d1e6e110e",
        "rel": "self"}]
}
 

Example of ordering transfer .us domain.

Request

PUT /accounts/acct839326/domains/ng-test-fitnesse-shortcut-20130412-0940.us
Content-Type: application/json; charset=UTF-8
Authorization: Basic ...

{
   "domainName": "ng-test-fitnesse-shortcut-20130412-0940.us",
   "operation": "transfer",
   "term": 1,
   "authInfo" : "mysecret",
   "nameservers" : [ "ns1.test.com", "ns2.test.com" ],
   "additionalParams" : { "usNexusCode": "P1", "usNexusCategory": "C11" },
   "contactInfo" : {
      "registrant": {
         "type": "registrant",
         "firstName": "John",
         "lastName": "Doe",
         "company": "ACME Inc.",
         "street1": "123 First Str.",
         "city": "Chicago",
         "zipOrPostal": "34567",
         "stateOrProvince": "IL",
         "countryCode": "US",
         "email1": "john.doe@test.com",
         "phone1": "+1.312.456789098"
      },
      "administrative": {
         "type": "administrative",
         ...
      },
      "billing": {
         "type": "billing",
         ...
      },
      "technical": {
         "type": "technical",
         ...
      }
   }
}
 

Response

202 Accepted

{
   "orderId": "0000013dfeb0db5aa6c51427000ac81d1e6e110e",
   "links":
      [{"href": "http://coreapi01.ote.chicago.hostway:8100/orders/0000013dfeb0db5aa6c51427000ac81d1e6e110e",
        "rel": "self"}]
}
 

See also

• Domain Name Registration API
• Common Features