Menu
Amazon Route 53
API Reference

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

Copy
{ "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

Copy
{ "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", "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 for the admin contact is concealed from WHOIS queries. If the value is true, WHOIS ("who is") queries will return contact information for our registrar partner, Gandi, instead of the contact information that you enter.

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 format is Unix time.

Type: Timestamp

DnsSec

Reserved for future use.

Type: String

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 format is Unix time.

Type: Timestamp

Nameservers

The name of the domain.

Type: Array of Nameserver objects

RegistrantContact

Provides details about the domain registrant.

Type: ContactDetail object

RegistrantPrivacy

Specifies whether contact information for the registrant contact is concealed from WHOIS queries. If the value is true, WHOIS ("who is") queries will return contact information for our registrar partner, Gandi, instead of the contact information that you enter.

Type: Boolean

RegistrarName

Name of the registrar of the domain as identified in the registry. Amazon Route 53 domains are registered by registrar Gandi. The value 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 Amazon 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 for the tech contact is concealed from WHOIS queries. If the value is true, WHOIS ("who is") queries will return contact information for our registrar partner, Gandi, instead of the contact information that you enter.

Type: Boolean

UpdatedDate

The last updated date of the domain as found in the response to a WHOIS query. The date format is Unix time.

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 an OperationId it may refer to the ID of an operation that is already completed. For a domain name, it may not be a valid domain name or belong to the requester account.

HTTP Status Code: 400

UnsupportedTLD

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

HTTP Status Code: 400

Example

GetDomainDetail Example

Sample Request

Copy
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

Copy
HTTP/1.1 200 Content-Length:[number of characters in the JSON string] { "AbuseContactEmail":"abuse@support.gandi.net", "AbuseContactPhone":"+33.170377661", "AdminContact":{ "AddressLine1":"1 Any Street", "AddressLine2":"", "City":"Anytown", "CountryCode":"US", "Email":"john@example.com", "ExtraParams":[ ], "FirstName":"John", "LastName":"Doe", "PhoneNumber":"+2065550100", "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":"john@example.com", "ExtraParams":[ ], "FirstName":"John", "LastName":"Doe", "PhoneNumber":"+2065550100", "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":"john@example.com", "ExtraParams":[ ], "FirstName":"John", "LastName":"Doe", "PhoneNumber":"+2065550100", "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: