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 isfalse
, 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 isfalse
, 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 isfalse
, 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":"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: