Domains-domainName:GET - Revision history

Mike.robski: 1 revision: Release 87

2013-11-15T21:21:53Z

1 revision: Release 87

Philip.rittscher at 00:22, 16 May 2013

2013-05-16T00:22:21Z

Mike.robski: Update to the response when the domain name is available. In Staging on 4/1/13. In production on 4/10/13.

2013-03-27T18:06:23Z

Update to the response when the domain name is available. In Staging on 4/1/13. In production on 4/10/13.

Mike.robski: 1 revision

2013-02-18T04:29:17Z

1 revision

Mike.robski at 04:11, 18 February 2013

2013-02-18T04:11:58Z

New page

= GET /domains/''{domainName}'' =
Performs domain availability check.
__TOC__
== Request ==
<code>GET /domains/''{domainName}''</code>

==== Parameters ====
; domainName - string
: The valid domain name to check including only the labels that are appropriate for the valid registration of a domain name at the registry. IE: '''example.com''' is a valid domain name that could be or is already registered at the registry. 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.

== Response ==

=== Status Code ===
An HTTP response code value indicating ancillary information about the domain availability. See notes below for the meaning of the response code. Check the 'available' value to determine if the given domain name is available at the registry.

;200 OK
: Domain is registered and does not exist in ServicePlex. The 'available' result will always indicate 'false' in this case and the domain can be presented as already taken and perhaps transferable to ServicePlex.

;203 Non Authoritative
: Domain is already registered in ServicePlex. Check the 'available' result to see if the domain exists at the registry already. For example, a domain may be pending provisioning and therefore it already exists in ServicePlex and so is not available for registration even if the 'available' value is 'true'

;400 Bad Request
: The domain name is not valid.

;404 Not Found
: The domain does not exist at the registry and no records of it are found in ServicePlex. It can therefore be safely presented as a registerable domain.

;412 Unauthorized
: Domain is not permitted for registration in ServicePlex. Check the 'available' value to see if the domain is registered at the registry. A domain might not be permitted if it is in a restricted list of domain names that are prevented from being registered in ServicePlex. For example '''buy-olympic-tickets.com''' might be available but it is restricted. Special privileges are required to register restricted domains.

=== Response Body ===
<nowiki>
{
"available": "{available}",
"name": "{domainName}"
}
</nowiki>

==== Parameters ====
; available - ''boolean''
: Indicates if the domain is ''available'' for registration '''true''', or if the domain is already registered and subsequently not available for registration '''false'''. The value of 'available' is determined by checking the registry to see if a record of the domain exists or not, independent of the status or rules for registering the domain in ServicePlex.

; domainName - ''string''
: The domain name that was supplied in the GET request.

== See also ==
* [[Domain Name Registration|Domain Name Registration API]]
* [[Common Features]]

{{disqus}}
[[Category:Hostway API]]
[[Category:Domain Name Registration API]]

@@ Line 40: / Line 40: @@
 ; domainName - ''string''
 : The domain name that was supplied in the GET request.
 == See also ==
 * [[Domain Name Registration|Domain Name Registration API]]
 * [[Common Features]]

@@ Line 15: / Line 15: @@
 ;200 OK
-: Domain is registered and does not exist in ServicePlex. The 'available' result will always indicate 'false' in this case and the domain can be presented as already taken and perhaps transferable to ServicePlex.
+: Domain is either registered and does not exist in ServicePlex, or available. The 'available' result will be 'false' if the domain is registered (in this case and the domain can be presented as already taken and perhaps transferable to ServicePlex) and 'true' if the name is available.
 ;203 Non Authoritative
@@ Line 22: / Line 22: @@
 ;400 Bad Request
 : The domain name is not valid.
 ;412 Unauthorized