http://docs.hostway.com/index.php?action=history&feed=atom&title=Domains-domainName-hold%3AGETDomains-domainName-hold:GET - Revision history2026-04-04T09:56:18ZRevision history for this page on the wikiMediaWiki 1.18.0http://docs.hostway.com/index.php?title=Domains-domainName-hold:GET&diff=979&oldid=prevMike.robski: 1 revision: Release 872013-11-15T21:22:07Z<p>1 revision: Release 87</p>
<table class='diff diff-contentalign-left'>
<tr valign='top'>
<td colspan='1' style="background-color: white; color:black;">← Older revision</td>
<td colspan='1' style="background-color: white; color:black;">Revision as of 21:22, 15 November 2013</td>
</tr></table>Mike.robskihttp://docs.hostway.com/index.php?title=Domains-domainName-hold:GET&diff=978&oldid=prevVenzi.iliev: /* Example of getting the domain hold status. */2013-03-27T15:44:25Z<p><span class="autocomment">Example of getting the domain hold status.</span></p>
<p><b>New page</b></p><div>= GET /domains/''{domainName}''/hold =<br />
Get the current hold status of a domain. This corresponds to a status of 'clientHold' at the registry. A domain name with this status is removed from the registry zone files and will cease resolving but may be transferred to another registrar, may be renewed and it may be modified; such as changes to the name servers or contact info.<br />
<br />
__TOC__<br />
== Request ==<br />
<code>GET /domains/''{domainName}''/hold</code><br />
<br />
==== Parameters ====<br />
; domainName - string<br />
: The valid domain name. IE: '''example.com''' is a valid domain name , 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. The domain name must be an open or suspended product under the authenticated franchise.<br />
<br />
=== URI Parameters ===<br />
None.<br />
<br />
=== Request Headers ===<br />
None.<br />
<br />
=== Request Body ===<br />
None.<br />
<br />
== Response ==<br />
<br />
=== Status Code ===<br />
;200 OK<br />
: Returns the domain hold status.<br />
<br />
;400 Bad Request<br />
: The domain name is not valid.<br />
<br />
;403 Forbidden<br />
: Domain is not registered in this account and cannot be accessed.<br />
<br />
;404 Not Found<br />
: No domain records found for the given domain name.<br />
<br />
<br />
=== Response Body ===<br />
;true<br />
:Means that domain hold status is set, domain is on-hold.<br />
<br />
;false<br />
:Means that domain hold status is not set, domain is not on-hold.<br />
<br />
== Example of getting the domain hold status. ==<br />
'''Request'''<br />
<nowiki><br />
GET /domains/example.com/hold<br />
<br />
</nowiki><br />
<br />
'''Response'''<br />
<nowiki><br />
200 OK<br />
Content-Type: application/json; charset=UTF-8<br />
<br />
true<br />
</nowiki><br />
<br />
== See also ==<br />
* [[Domain Name Registration|Domain Name Registration API]]<br />
* [[Common Features]]<br />
<br />
{{disqus}}<br />
[[Category:Hostway API]]<br />
[[Category:Domain Name Registration API]]</div>Venzi.iliev