Domain API

ICANN has reviewed the policies that govern domain transfers in the gTLD and nTLD spaces, and came up with a new Transfer Policy which includes a new process: Registrant Transfer (Change of Registrant). This new Transfer Policy will become effective on December 1, 2016. A change of registrant have to be requested with a TradeDomain command.

Following new parameters are created:
Designated Agent (DA) of the new registrant: X-CONFIRM-DA-NEW-REGISTRANT = 1
Designated Agent (DA) of the old registrant: X-CONFIRM-DA-OLD-REGISTRANT = 0 | 1

TRADEDOMAIN

[COMMAND]

COMMAND = TradeDomain
DOMAIN = <DOMAIN>

REQUIRED

OWNERCONTACT0 = <CONTACT>
X-CONFIRM-DA-NEW-REGISTRANT = 1

OPTIONAL

X-CONFIRM-DA-OLD-REGISTRANT = 1

[RESPONSE]

DESCRIPTION = Command completed successfully; realtime domain trade succeeded
CODE = 200

Information

The domain will locked for transfer for sixty (60) days, after a successful execution of the TradeDomain command.

STATUSDOMAIN

[COMMAND]

COMMAND = StatusDomain
DOMAIN = <DOMAIN>

[RESPONSE]

CODE = 200
DESCRIPTION = Command completed successfully
PROPERTY[STATUS][0] = ACTIVE
PROPERTY[STATUS][1] = clientTransferProhibited
...
PROPERTY[CURRENT-REGISTRANT-NAME][0] = ...
PROPERTY[CURRENT-REGISTRANT-ORGANIZATION][0] = ...
PROPERTY[CURRENT-REGISTRANT-EMAIL][0] = ...
...
PROPERTY[TRANSFERLOCK][0] = 1
PROPERTY[TRANSFERLOCK-EXPIRATIONDATE][0] = YYYY-MM-DD HH:MM:SS
PROPERTY[TRADE-TRANSFERLOCK-EXPIRATIONDATE][0] = YYYY-MM-DD HH:MM:SS
...

MODIFYDOMAIN

A removal of the transferlock via a ModifyDomain command is not possible for sixty (60) days, after a successful change of registrant without the OPT-OUT option.

[COMMAND]

COMMAND = ModifyDomain
DOMAIN = <DOMAIN>
...

OPTIONAL

TRANSFERLOCK = 0

[RESPONSE]

CODE = 552
DESCRIPTION = Object status does not allow for operation; Change of Registrant TRANSFERLOCK in place until YYYY-MM-DD HH:MM:SS

TRADEDOMAIN with OPT-OUT

To avoid the sixty (60) days transferlock, you have the option to request the TradeDomain command with the additional parameter X-REQUEST-OPT-OUT-TRANSFERLOCK = 1. The activation of this parameter trigger an e-Mail. The old registrant getting an e-Mail for the confirmation of the change of registrant. This e-Mail have to be approved within fourteen (14) days to complete the TRADE request and avoid the sixty (60) days transferlock.

[COMMAND]

COMMAND = TradeDomain
DOMAIN = <DOMAIN>

REQUIRED

OWNERCONTACT0 = P-ABC123
X-CONFIRM-DA-NEW-REGISTRANT = 1
X-REQUEST-OPT-OUT-TRANSFERLOCK = 1

OPTIONAL

X-CONFIRM-DA-OLD-REGISTRANT = 0

[RESPONSE]

DESCRIPTION = Command completed successfully; trade pending - non-real-time
CODE = 200
PENDING = 1