http://docs.hostway.com/index.php?action=history&feed=atom&title=Accounts-accountNumber-domains-transfer-domainName%3APUT 2026-04-25T17:53:50Z Revision history for this page on the wiki MediaWiki 1.18.0 http://docs.hostway.com/index.php?title=Accounts-accountNumber-domains-transfer-domainName:PUT&diff=1302&oldid=prev 2014-05-08T07:35:04Z

<p>1 revision: Release 93</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 07:35, 8 May 2014</td> </tr></table>

Mike.robski http://docs.hostway.com/index.php?title=Accounts-accountNumber-domains-transfer-domainName:PUT&diff=1301&oldid=prev 2014-04-24T00:33:58Z

<p></p> <p><b>New page</b></p><div>= PUT /accounts/''{accountNumber}''/domains/transfers/''{domainName}'' =<br /> A domain name transfer is a long running process that may run into several problems along they way. If a problem occurs, a domain transfer will block for up to 60 days. The reset call is made to retry the transfer based on some change that will remove the impediment to the transfer's progress. Possible reasons that a transfer will block are:<br /> * Domain status at the registry prevented the transfer: for example the domain was locked, or in redemptionPeriod<br /> * Wrong authInfo was supplied and the registry rejected the attempt<br /> * Domain was registered for less that 60 days at the time the transfer was attempted<br /> * The registrar or customer rejected the transfer request (NACK)<br /> * The current authorized contact of the domain failed to respond to the request to authorize the transfer<br /> * The domain was already pending transfer at the registry<br /> <br /> <br /> <br /> __TOC__<br /> == Request ==<br /> &lt;code&gt;PUT /accounts/''{accountNumber}''/domains/transfers/''{domainName}''&lt;/code&gt;<br /> <br /> === URI Parameters ===<br /> ;accountNumber<br /> : client account number<br /> {{DomainTransfer}}<br /> <br /> === Request Headers ===<br /> Content-type: application/json<br /> <br /> === Request Body ===<br /> &lt;nowiki&gt;<br /> {<br /> 'authInfo': '{authInfo}'<br /> }<br /> &lt;/nowiki&gt;<br /> <br /> === Parameters ===<br /> ;authInfo - string <br /> The authInfo passed in the request body is optional. If a value is passed it must be a valid authInfo string from 6 to 16 characters in length. If no authInfo is passed the previous value will be used. In the case where the previous value was not accepted by the registry, a new authInfo should be supplied or the existing registrar should update the authInfo to the value that was previously used. <br /> <br /> == Response ==<br /> <br /> === Status Code ===<br /> ;202 OK<br /> : Domain transfer has been reset<br /> <br /> ;404 Bad Request<br /> : One of the required parameters accountNumber, domainName or authInfo was missing or invalid.<br /> <br /> ;404 Not Found<br /> : No pending transfer order found for this domain.<br /> <br /> ;403 Forbidden<br /> : The domain transfer does not belong to the given customer account.<br /> <br /> ;409 Conflict<br /> : Domain transfer is pending but is not in a state that can be reset. For example, the transfer was successfully sent to the registry and is awaiting a response from the current registrar. Use the call to get domain transfer status to see if the domain may be reset.<br /> <br /> ;500 Internal Server Error<br /> : An unknown error occurred.<br /> <br /> === Response Body ===<br /> No body.<br /> <br /> === Parameters ===<br /> No response parameters.<br /> <br /> == Example of getting transfer status. ==<br /> '''Request'''<br /> &lt;nowiki&gt;<br /> PUT /accounts/acct12345/domains/transfers/test.com<br /> <br /> {<br /> 'authInfo': 'mySecret'<br /> }<br /> &lt;/nowiki&gt;<br /> <br /> '''Response'''<br /> &lt;nowiki&gt;<br /> 204 OK<br /> &lt;/nowiki&gt;<br /> <br /> == See also ==<br /> * [[Common Features]]<br /> <br /> {{disqus}}<br /> [[Category:Hostway API]]<br /> [[Category:Domain Name Registration API]]</div>

Philip.rittscher