All domain commands: (check) (create) (delete) (info) (modify) (transfer) (renew) (undelete) (privacy) (autorenew)

Domain info

To retrieve information about a domain object you need to use the domain:info command. This has just one sub element and a single attribute. if the hosts attribute is set to "all" all hosts belonging to the domain will be included in the results. If there is no value or the attribute is not set a list of just the nameservers for the domain is added to the domain:infData. If the attribute is set to "none" no nameservers or host objects are added to the domain.

Example domain info command

<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <command> <info> <domain:info> <domain:name>docu-test-case-2.nl</domain:name> <domain:authInfo> <domain:pw></domain:pw> </domain:authInfo> </domain:info> </info> </command> </epp>

Response

You will then receive a normal domain info response. Please note that almost all response fields are wrapped in CDATA to make sure that strange characters do not mess with the XML structure. <?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <response> <resData> <domain:infData> <domain:name><![CDATA[docu-test-case.nl]]></domain:name> <domain:roid><![CDATA[8324c29d-6dc8-4ffa-a70c-bf31c587af71]]></domain:roid> <domain:status s="ok"><![CDATA[active]]></domain:status> <domain:registrant><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:registrant> <domain:contact type="admin"><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:contact> <domain:contact type="tech"><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:contact> <domain:contact type="billing"><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:contact> <domain:ns> <domain:hostObj><![CDATA[ns2.metaregistrar.com]]></domain:hostObj> <domain:hostObj><![CDATA[ns1.metaregistrar.com]]></domain:hostObj> </domain:ns> <domain:authInfo> <domain:pw><![CDATA[44uMwYpEG95N]]></domain:pw> </domain:authInfo> <domain:clID><![CDATA[mtrewoutdg]]></domain:clID> <domain:crID><![CDATA[mtrewoutdg]]></domain:crID> <domain:crDate><![CDATA[2016-09-07T11:10:45.000000+0000]]></domain:crDate> <domain:upID><![CDATA[mtrewoutdg]]></domain:upID> <domain:upDate><![CDATA[2016-09-07T11:10:47.000000+0000]]></domain:upDate> <domain:exDate><![CDATA[2017-09-07T00:00:00.000000+0000]]></domain:exDate> </domain:infData> </resData> <trID> <svTRID>MTR_54dd46c6c3a9111d66e70b2ec5d5c3ac64e1a432</svTRID> </trID> </response> </epp>

Domain names in quarantine

The case below is an example of a domain name that is in quarantine (redemption period). This domain name is deleted, but not released to the public yet. In this state, only the original owner may restore the domain name to its original state. The restore command can be found here: (undelete)

<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> <response> <resData> <domain:infData> <domain:name><![CDATA[docu-test-case.nl]]></domain:name> <domain:roid><![CDATA[00e46547-b621-4ed9-b485-f1250a072e42]]></domain:roid> <domain:status s="redemptionPeriod"></domain:status> <domain:status s="pendingDelete"></domain:status> <domain:registrant><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:registrant> <domain:contact type="admin"><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:contact> <domain:contact type="billing"><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:contact> <domain:contact type="tech"><![CDATA[RP012rfX8Wa3dE9u4Nu59g6J]]></domain:contact> <domain:ns> <domain:hostObj><![CDATA[ns2.metaregistrar.com]]></domain:hostObj> <domain:hostObj><![CDATA[ns1.metaregistrar.com]]></domain:hostObj> </domain:ns> <domain:authInfo> <domain:pw><![CDATA[UHj62VBVp6YK]]></domain:pw> </domain:authInfo> <domain:clID><![CDATA[mtrewoutdg]]></domain:clID> <domain:crID><![CDATA[mtrewoutdg]]></domain:crID> <domain:crDate><![CDATA[2016-09-07T11:09:44.000000+0000]]></domain:crDate> <domain:upID><![CDATA[mtrewoutdg]]></domain:upID> <domain:upDate><![CDATA[2016-09-07T11:09:53.000000+0000]]></domain:upDate> <domain:exDate><![CDATA[2017-09-07T00:00:00.000000+0000]]></domain:exDate> </domain:infData> </resData> <trID> <svTRID>MTR_2ebb7e2b71fbf5dd5160e1c5ac864101f37cad28</svTRID> </trID> </response> </epp>

Pending validation

.COM, .NET and new GTLD domain names have a validation process that requires the client to validate his or her e-mail address before the domain name is activated. The unvalidated domains have a status of pendingValidation on the domain:info command <?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:ext="http://www.metaregistrar.com/epp/ext-1.0" xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1"> <response> <resData> <domain:infData> <domain:name><![CDATA[docu-test-case.com]]></domain:name> <domain:roid><![CDATA[59df8eab-7e84-4d6b-ad38-888eb97016b6]]></domain:roid> <domain:status s="pendingValidation"></domain:status> <domain:registrant><![CDATA[RP01mS4QzdukMwTuVhN45E5m]]></domain:registrant> <domain:contact type="admin"><![CDATA[RP01mS4QzdukMwTuVhN45E5m]]></domain:contact> <domain:contact type="tech"><![CDATA[RP01mS4QzdukMwTuVhN45E5m]]></domain:contact> <domain:contact type="billing"><![CDATA[RP01mS4QzdukMwTuVhN45E5m]]></domain:contact> <domain:ns> <domain:hostObj><![CDATA[ns2.metaregistrar.com]]></domain:hostObj> <domain:hostObj><![CDATA[ns1.metaregistrar.com]]></domain:hostObj> </domain:ns> <domain:authInfo> <domain:pw><![CDATA[}uCTzC42%79aviHe]]></domain:pw> </domain:authInfo> <domain:clID><![CDATA[mtrewoutdg]]></domain:clID> <domain:crID><![CDATA[mtrewoutdg]]></domain:crID> <domain:crDate><![CDATA[2016-09-07T13:50:02.000000+0000]]></domain:crDate> <domain:upID><![CDATA[mtrewoutdg]]></domain:upID> <domain:upDate><![CDATA[2016-09-07T13:50:08.000000+0000]]></domain:upDate> <domain:exDate><![CDATA[2017-09-07T13:50:02.000000+0000]]></domain:exDate> </domain:infData> </resData> <trID> <svTRID>MTR_1ebe8dbd25737ec2595df16b19742f964aa4cde1</svTRID> </trID> </response> </epp>