GetDomainDetail

This operation returns detailed information about a specified domain that is associated with the current AWS account. Contact information for the domain is also returned as part of the output.

Request Syntax

{
   "DomainName": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

DomainName

The name of the domain that you want to get detailed information about.

Type: String

Length Constraints: Maximum length of 255.

Required: Yes

Response Syntax

{
   "AbuseContactEmail": "string",
   "AbuseContactPhone": "string",
   "AdminContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "AdminPrivacy": boolean,
   "AutoRenew": boolean,
   "CreationDate": number,
   "DnsSec": "string",
   "DnssecKeys": [ 
      { 
         "Algorithm": number,
         "Digest": "string",
         "DigestType": number,
         "Flags": number,
         "Id": "string",
         "KeyTag": number,
         "PublicKey": "string"
      }
   ],
   "DomainName": "string",
   "ExpirationDate": number,
   "Nameservers": [ 
      { 
         "GlueIps": [ "string" ],
         "Name": "string"
      }
   ],
   "RegistrantContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "RegistrantPrivacy": boolean,
   "RegistrarName": "string",
   "RegistrarUrl": "string",
   "RegistryDomainId": "string",
   "Reseller": "string",
   "StatusList": [ "string" ],
   "TechContact": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "City": "string",
      "ContactType": "string",
      "CountryCode": "string",
      "Email": "string",
      "ExtraParams": [ 
         { 
            "Name": "string",
            "Value": "string"
         }
      ],
      "Fax": "string",
      "FirstName": "string",
      "LastName": "string",
      "OrganizationName": "string",
      "PhoneNumber": "string",
      "State": "string",
      "ZipCode": "string"
   },
   "TechPrivacy": boolean,
   "UpdatedDate": number,
   "WhoIsServer": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

AbuseContactEmail

Email address to contact to report incorrect contact information for a domain, to report that the domain is being used to send spam, to report that someone is cybersquatting on a domain name, or report some other type of abuse.

Type: String

Length Constraints: Maximum length of 254.

AbuseContactPhone

Phone number for reporting abuse.

Type: String

Length Constraints: Maximum length of 30.

AdminContact

Provides details about the domain administrative contact.

Type: ContactDetail object

AdminPrivacy

Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS ("who is") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the admin contact.

Type: Boolean

AutoRenew

Specifies whether the domain registration is set to renew automatically.

Type: Boolean

CreationDate

The date when the domain was created as found in the response to a WHOIS query. The date and time is in Unix time format and Coordinated Universal time (UTC).

Type: Timestamp

DnsSec

Deprecated.

Type: String

DnssecKeys

A complex type that contains information about the DNSSEC configuration.

Type: Array of DnssecKey objects

DomainName

The name of a domain.

Type: String

Length Constraints: Maximum length of 255.

ExpirationDate

The date when the registration for the domain is set to expire. The date and time is in Unix time format and Coordinated Universal time (UTC).

Type: Timestamp

Nameservers

The name servers of the domain.

Type: Array of Nameserver objects

RegistrantContact

Provides details about the domain registrant.

Type: ContactDetail object

RegistrantPrivacy

Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS ("who is") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the registrant contact (domain owner).

Type: Boolean

RegistrarName

Name of the registrar of the domain as identified in the registry. Domains with a .com, .net, or .org TLD are registered by Amazon Registrar. All other domains are registered by our registrar associate, Gandi. The value for domains that are registered by Gandi is "GANDI SAS".

Type: String

RegistrarUrl

Web address of the registrar.

Type: String

RegistryDomainId

Reserved for future use.

Type: String

Reseller

Reseller of the domain. Domains registered or transferred using Route 53 domains will have "Amazon" as the reseller.

Type: String

StatusList

An array of domain name status codes, also known as Extensible Provisioning Protocol (EPP) status codes.

ICANN, the organization that maintains a central database of domain names, has developed a set of domain name status codes that tell you the status of a variety of operations on a domain name, for example, registering a domain name, transferring a domain name to another registrar, renewing the registration for a domain name, and so on. All registrars use this same set of status codes.

For a current list of domain name status codes and an explanation of what each code means, go to the ICANN website and search for epp status codes. (Search on the ICANN website; web searches sometimes return an old version of the document.)

Type: Array of strings

TechContact

Provides details about the domain technical contact.

Type: ContactDetail object

TechPrivacy

Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS ("who is") queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the technical contact.

Type: Boolean

UpdatedDate

The last updated date of the domain as found in the response to a WHOIS query. The date and time is in Unix time format and Coordinated Universal time (UTC).

Type: Timestamp

WhoIsServer

The fully qualified name of the WHOIS server that can answer the WHOIS query for the domain.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

InvalidInput

The requested item is not acceptable. For example, for APIs that accept a domain name, the request might specify a domain name that doesn't belong to the account that submitted the request. For AcceptDomainTransferFromAnotherAwsAccount, the password might be invalid.

HTTP Status Code: 400

UnsupportedTLD

Amazon Route 53 does not support this top-level domain (TLD).

HTTP Status Code: 400

Examples

GetDomainDetail Example

This example illustrates one usage of GetDomainDetail.

Sample Request

POST / HTTP/1.1
host:route53domains.us-east-1.amazonaws.com
x-amz-date:20140711T205230Z
authorization:AWS4-HMAC-SHA256
              Credential=AKIAIOSFODNN7EXAMPLE/20140711/us-east-1/route53domains/aws4_request,
              SignedHeaders=content-length;content-type;host;user-agent;x-amz-date;x-amz-target,
              Signature=[calculated-signature]
x-amz-target:Route53Domains_v20140515.GetDomainDetail
user-agent:aws-sdk-java/1.8.3 Linux/2.6.18-164.el5PAE Java_HotSpot (TM )_Server_VM/24.60-b09/1.7.0_60
content-type:application/x-amz-json-1.1
content-length:[number of characters in the JSON string]
{
   "DomainName":"example.com"
}

Sample Response

HTTP/1.1 200
Content-Length:[number of characters in the JSON string]
{
   "AbuseContactEmail":"[e-mail]",
   "AbuseContactPhone":"+33.170377661",
   "AdminContact":{
      "AddressLine1":"1 Any Street",
      "AddressLine2":"",
      "City":"Anytown",
      "CountryCode":"US",
      "Email":"[e-mail]",
      "ExtraParams":[
      ],
      "FirstName":"John",
      "LastName":"Doe",
      "PhoneNumber":"[phone]",
      "State":"WA",
      "ZipCode":"98101"
   },
   "AdminPrivacy":true,
   "AutoRenew":true,
   "CreationDate":1400010459,
   "DomainName":"example.com",
   "ExpirationDate":1431539259,
   "Nameservers":[
      {
         "GlueIps":[
         ],
         "Name":"ns-2048.awsdns-64.com"
      },
      {
         "GlueIps":[
         ],
         "Name":"ns-2051.awsdns-67.co.uk"
      },
      {
         "GlueIps":[
         ],
         "Name":"ns-2050.awsdns-66.org"
      },
      {
         "GlueIps":[
         ],
         "Name":"ns-2049.awsdns-65.net"
      }
   ],
   "RegistrantContact":{
      "AddressLine1":"1 Any Street",
      "AddressLine2":"",
      "City":"Anytown",
      "CountryCode":"US",
      "Email":"[e-mail]",
      "ExtraParams":[
      ],
      "FirstName":"John",
      "LastName":"Doe",
      "PhoneNumber":"[phone]",
      "State":"WA",
      "ZipCode":"98101"
   },
   "RegistrantPrivacy":true,
   "RegistrarName":"GANDI SAS",
   "RegistrarUrl":"http://www.gandi.net",
   "Reseller":"Amazon",
   "StatusList":[
   "clientTransferProhibited"
   ],
   "TechContact":{
      "AddressLine1":"1 Any Street",
      "AddressLine2":"",
      "City":"Anytown",
      "CountryCode":"US",
      "Email":"[e-mail]",
      "ExtraParams":[
      ],
      "FirstName":"John",
      "LastName":"Doe",
      "PhoneNumber":"[phone]",
      "State":"WA",
      "ZipCode":"98101"
      },
   "TechPrivacy":true,
   "UpdatedDate":1400010459,
   "WhoIsServer":"whois.gandi.net"
}

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS SDK for JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3