GetDomainDetail
This operation returns detailed information about a specified domain that is associated with the current Amazon Web Services 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,
"BillingContact": {
"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"
},
"BillingPrivacy": 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 or for our registrar associate, Gandi. 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
- BillingContact
-
Provides details about the domain billing contact.
Type: ContactDetail object
- BillingPrivacy
-
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 or for our registrar associate, Gandi. If the value isfalse
, WHOIS queries return the information that you entered for the billing contact.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 or for our registrar associate, Gandi. 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.
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 or for our registrar associate, Gandi. 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 Amazon SDKs, see the following: