Info
Purpose⚓
Retrieve complete WHOIS information on a Domain Name Record.
Authority⚓
An Info Domain Request can be submitted by any AR.
Result⚓
A valid request is processed immediately.
If the querying client is the sponsoring (managing) registrar, all available information is returned.
If the querying client is not the sponsoring registrar, full information is returned only if valid authorization information (Auth Code) is provided.
The authorization code will be provided only by the managing registrar upon request.
Code Example⚓
Request by sponsoring / managing registrar⚓
<?xml version="1.0" encoding="UTF-8"?>
<epp>
<command>
<info>
<domain:info>
<domain:name>example.org.il</domain:name>
</domain:info>
</info>
<clTRID>SS-5</clTRID>
</command>
</epp>
Request by non-sponsoring registrar (with Auth Code)⚓
<?xml version="1.0" encoding="UTF-8"?>
<epp>
<command>
<info>
<domain:info>
<domain:name>example.org.il</domain:name>
<domain:authInfo>
<domain:pw>XXXXXXX</domain:pw>
</domain:authInfo>
</domain:info>
</info>
<clTRID>FF-8</clTRID>
</command>
</epp>
Legend⚓
<info>: Defines that the desired Registration Action, is an information retrieval action, where:<domain:info>: defines that the requested information if on a Domain Name Record.<domain:name>: Defines the queried Domain Name Record.<domain:authInfo>: Authorization information for non-sponsoring registrars.<domain:pw>: Authorization code (Auth Code).
<clTRID>AR's transaction identifier
Tag occurrence table⚓
| Tag | Occurrences (MIN-MAX) |
Size + Remarks |
|---|---|---|
<epp> |
1 | |
<command> |
1 | |
<info> |
1 | |
<domain:info> |
1 | |
<secDNS:name> |
1 | |
<domain:authInfo> |
0..1 | Required only for non-sponsoring registrar |
<domain:pw> |
0..1 | Must be 6 - 20 characters long, allowed characters are: a-z, A-Z, 0-9, _ |
<clTRID> |
1 | Must start with 2 capital letters representing the registrar, followed by a hyphen (-) and a string of numbers. Must be unique per request. Total length may not exceed 30 characters. |
Authorization Code Validation⚓
When an auth code is required and validation fails, the following error codes may be returned:
3175,
3176,
3177,
3178,
3179,
3180
Additional Response Data (<resData> block)⚓
The API Server's response upon the successful completion of an Info Domain Request:
<?xml version="1.0" encoding="UTF-8"?>
<epp>
<response>
<result>
<code>1000</code>
<msg>Command completed successfully</msg>
</result>
<resData>
<domain:infData>
<domain:name>example.co.il</domain:name>
<domain:status>ok</domain:status>
<domain:contact type="admin">BB-BL1-IL</domain:contact>
<domain:contact type="tech">BB-BL1-IL</domain:contact>
<domain:contact type="zone">BB-BL1-IL</domain:contact>
<domain:ns>
<domain:hostAttr>
<domain:hostName />
<domain:hostAddr />
</domain:hostAttr>
(...)
<domain:hostAttr>
<domain:hostName />
<domain:hostAddr />
</domain:hostAttr>
</domain:ns>
<domain:dnsStatus>ok</domain:dnsStatus>
<domain:transferlocked>false</domain:transferlocked>
<domain:clID>BB</domain:clID>
<domain:crID>BB</domain:crID>
<domain:crDate>2006-02-26T11:39:37.000Z</domain:crDate>
<domain:upDate>2006-02-26T11:39:37.000Z</domain:upDate>
<domain:exDate>2008-02-26T23:59:59.000Z</domain:exDate>
</domain:infData>
</resData>
<extension>
<isocil:ext>
<isocil:infData>
<isocil:contact>
<isocil:type>registrant</isocil:type>
<contact:postalInfo type="loc">
<contact:name>Israel Israeli LTD</contact:name>
<contact:isOrganization>true</contact:isOrganization>
<contact:organizationId>512345679</contact:organizationId>
<contact:addr>
<contact:street>6 Bareket st.</contact:street>
<contact:city>Petach Tikva</contact:city>
<contact:zip>4951774</contact:zip>
<contact:cc>IL</contact:cc>
</contact:addr>
</contact:postalInfo>
<contact:voice>+972 3 9700900</contact:voice>
<contact:fax>+972 3 9700901</contact:fax>
<contact:email>[email protected]</contact:email>
<contact:crID>BB</contact:crID>
<contact:upDate>2006-02-26T11:39:37.000Z</contact:upDate>
<contact:crDate>2006-02-26T11:39:37.000Z</contact:crDate>
</isocil:contact>
</isocil:infData>
</isocil:ext>
<secDNS:infData xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1">
<secDNS:dsData>
<secDNS:keyTag>25845</secDNS:keyTag>
<secDNS:alg>8</secDNS:alg>
<secDNS:digestType>2</secDNS:digestType>
<secDNS:digest>1D368C0FDFBC6F1E28...A75C110F84C3</secDNS:digest>
</secDNS:dsData>
</secDNS:infData>
</extension>
<trID>
<clTRID>BB-120</clTRID>
<svTRID>ISOCIL-BB73 20060306155310</svTRID>
</trID>
</response>
</epp>
Response Legend⚓
<response>: The response block, where:<resData>: Standard EPP block.<domain:infData>: Data on the Domain Name Record where:<domain:name>: The Domain Name<domain:status>: Status of Domain Name. Available statuses are: 'ok', 'registrantVerification','Suspended'.<domain:dnsStatus>: Current status of the DNS. Available statuses are: 'ok', 'clientHold','serverHold','No DNS','DNS Disabled'.<domain:contact>: The Handles of the contacts listed for the Domain Name Record. Contact's Role is identified by the "type" attribute.<domain:ns>: DNS servers block (up to 13 DNS servers).<domain:trasnferlocked>: Indicates the Lock Trasnfer status of the Domain Name Record (either 'true' or 'false').<domain:clID>: Managing AR Code<domain:crID>: Domain creator AR Code<domain:crDate>: Domain name creation date<domain:upDate>: Domain name last update date<domain:exDate>: Domain name expiry update date
<extension>: ISOC-IL extension block for contacts. Specifies the defined DS RR data under<secDNS:infData>.<isocil:infData>: Data on the Domain's Registrant<secDNS:infData>: Data on the Domain's DNSSEC: