Pushing a Domain Name To Another Registrar
Synopsis
| Description: | A command to "push" a domain name to another registrar account. |
| URL: | https://toolkit.centralnic.com/srv/push_domain |
| HTTP Method: | POST |
| Requires Authentication?: | Yes |
| Requires SSL?: | Yes |
| Query Parameters: | |
| test | The test flag (eg 1 or 0, optional) |
| user | Your Registrar Handle ID |
| password | Your encrypted Registrar password |
| domain | The domain name (eg example.uk.com) |
| handle | The gaining registrar handle ID (eg H12345) |
You may request that a domain name on your account be "pushed" to another registrar account. A domain name may only be pushed if:
- the domain name is on your account
- the domain name's status is "Live"
- the "gaining" registrar has not opted-out of the "push" system
If the transaction is successful, the domain name will be immediately removed from your account. Any outstanding invoices will be credited to you and re-issued to the gaining account.
If you are also listed as Technical Contact for the domain name, then this handle will also be changed to the gaining registrar account.
This command will also transfer sponsorship of the client and/or technical handles for the domain name, but only if these handles are not associated with any other domains on your account. Where a handle is associated with domains on multiple registrar accounts, the handle becomes "unsponsored".
We will send an e-mail to the gaining registrar notifying them of the domain transfer.
Test Mode
When the test=1 parameter is supplied, all actions are run against the test database rather than the live database. Additionally, an e-mail is not sent to the gaining registrar.
Response Format
The response will be of the form
Status: 0 Message: domain has been transferred.
In the event of an error, the server will return something like this:Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Domain not found.
or
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Gaining handle 'H12345' is refusing transfers.