Domain API

ICANN has reviewed the policies that govern domain transfers in the gTLD and nTLD spaces and has come up with a new Transfer Policy which includes a new process: Registrant Transfer (Change of Registrant). This new Transfer Policy will become effective 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
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) day 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 triggers an email. The old registrant will receive an email requesting the confirmation of the change of registrant. This email 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