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 ID (eg H12345) |
| password | Your Toolkit Password |
| domain | The domain name (eg example.uk.com) |
| handle | The gaining registrar 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
- there are no unpaid registration or renewal fees against it
If the transaction is successful, the domain name will be immediately removed from your account.
If you are also listed as Technical Contact for the domain name, then this contact association will also be changed to the gaining registrar account.
This command will also transfer sponsorship of the client and/or technical contacts for the domain name, but only if these contact objects are not associated with any other domains on your account. Where a contact object is associated with domains on multiple registrar accounts, the contact object 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.