tld:info

Obtaining additional information about a top level domain

Not all top level domains follow the same rules, most of the top level domains have for example a minimum subscription period of one year, for some however at least two years are required. To get the information about a top level domain you can use the following XML request.

XML Template
<?xml version="1.0" encoding="UTF-8"?>
<request xmlns:tld="http://www.eurodns.com/tld">
    <tld:info>
        <tld:name>#TLD#</tld:name>
    </tld:info>
</request>

<tld:info> (Occurences: 1)
<tld:name> (Occurences: 1)
R #TLD# Top level domain (COM for example)

The following code will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns:tld="http://www.eurodns.com/tld">
    <result code="1000">
        <msg>Command completed successfully</msg>
    </result>
    <resData>
        <tld:name>#TLD#</tld:name>
        <tld:category>#CATEGORY#</tld:category>
        <tld:country>#COUNTRY#</tld:country>
        <tld:minSubPeriod>#MINIMUM SUBSCRIPTION PERIOD#</tld:minSubPeriod>
        <tld:incSubPeriod>#INCREMENT SUBSCRIPTION PERIOD#</tld:incSubPeriod>
        <tld:maxSubPeriod>#MAXIMUM SUBSCRIPTION PERIOD#</tld:maxSubPeriod>
        <tld:regDelay>#REGISTRATION DELAY#</tld:regDelay>
        <tld:minRenPeriod>#MINIMUM RENEW PERIOD#</tld:minRenPeriod>
        <tld:incRenPeriod>#INCREMENT RENEW PERIOD#</tld:incRenPeriod>
        <tld:maxRenPeriod>#MAXIMUM RENEW PERIOD#</tld:maxRenPeriod>
        <tld:dayRenBeforeExpiration>#RENEW BEFORE EXPIRATION#</tld:dayRenBeforeExpiration>
        <tld:minCharAllowed>#MINIMUM CHAR ALLOWED#</tld:minCharAllowed>
        <tld:maxCharAllowed>#MAXIMUM CHAR ALLOWED#</tld:maxCharAllowed>
        <tld:hyphenAllowed>#HYPHEN ALLOWED#</tld:hyphenAllowed>
        <tld:numberAllowed>#NUMBER ALLOWED#</tld:numberAllowed>
        <tld:localOCRequired>#LOCAL ORG CONTACT REQUIRED#</tld:localOCRequired>
        <tld:localACRequired>#LOCAL ADMIN CONTACT REQUIRED#</tld:localACRequired>
        <tld:localTCRequired>#LOCAL TECH CONTACT REQUIRED#</tld:localTCRequired>
        <tld:localBCRequired>#LOCAL BILLING CONTACT REQUIRED#</tld:localBCRequired>
        <tld:setupFee currency="#CURRENCY#">#SETUP FEE#</tld:setupFee>
        <tld:annualFee currency="#CURRENCY#">#ANNUAL FEE#</tld:annualFee>
        <tld:modificationFee currency="#CURRENCY#">#MODIFICATION FEE#</tld:modificationFee>
        <tld:tradeEnabled>#TRADE ENABLED#</tld:tradeEnabled>
        <tld:transferEnabled>#TRANSFER ENABLED#</tld:transferEnabled>
        <tld:transferOutEnabled>#TRANSFER OUT ENABLED#</tld:transferOutEnabled>
        <tld:updateEnabled>#UPDATE ENABLED#</tld:updateEnabled>
        <tld:updateOContactAllowed>#UPDATE O CONTACT ALLOWED#</tld:updateOContactAllowed>
        <tld:updateAContactAllowed>#UPDATE A CONTACT ALLOWED#</tld:updateAContactAllowed>
        <tld:updateTContactAllowed>#UPDATE T CONTACT ALLOWED#</tld:updateTContactAllowed>
        <tld:updateBContactAllowed>#UPDATE B CONTACT ALLOWED#</tld:updateBContactAllowed>
        <tld:updateLicenseeNeedTrade>#UPDATE LICENSEE NEED TRADE#</tld:updateLicenseeNeedTrade>
        <tld:tradeFee currency="#CURRENCY#">#TRADE FEE#</tld:tradeFee>
        <tld:tradeRequired>#TRADE REQUIRED#</tld:tradeRequired>
        <tld:tradeRequiredForFields>#TRADE FIELDS#</tld:tradeRequiredForFields>
        <tld:transferFee currency="#CURRENCY#">#TRANSFER FEE#</tld:transferFee>
        <tld:transferAddYear>#TRANSFER NUMBER OF FREE YEARS#</tld:transferAddYear>
        <tld:transferNeedAuthCode>#TRANSFER NEED AUTHCODE#</tld:transferNeedAuthCode>
        <tld:transferTradeEnabled>#TRANSFERTRADE ENABLED#</tld:transferTradeEnabled>
        <tld:restricted>#RESTRICTED#</tld:restricted>
        <tld:lockingEnabled>#LOCKING ENABLED#</tld:lockingEnabled>
        <tld:information><![CDATA[#ADDITIONAL INFORMATION#]]></tld:information>
        <tld:dnsSec>#DNSSEC ALLOWED#</tld:dnsSec>
        <tld:idn>#IDN ALLOWED#</tld:idn>
        <tld:needAdditionalInfoNew>#NEED ADDITIONAL INFO NEW#</tld:needAdditionalInfoNew>
        <tld:needAdditionalInfoUpdate>#NEED ADDITIONAL INFO UPDATE#</tld:needAdditionalInfoUpdate>
        <tld:needAdditionalInfoTransfer>#NEED ADDITIONAL INFO#</tld:needAdditionalInfoTransfer>
        <tld:needAdditionalInfoTrade>#NEED ADDITIONAL INFO TRADE#</tld:needAdditionalInfoTrade>
        <tld:needAdditionalInfoSunrise>#NEED ADDITIONAL INFO SUNRISE#</tld:needAdditionalInfoSunrise>
        <tld:needContactValidation>#NEED CONTACT VALIDATION#</tld:needContactValidation>
        <tld:transferNeedSignedDoc>#TRANSFER NEED SIGNED DOC#</tld:transferNeedSignedDoc>
        <tld:updateNsAllowed>#UPDATE NS ALLOWED#</tld:updateNsAllowed>
        <tld:renewalMethod>#RENEWAL METHOD#</tld:renewalMethod>
        <tld:renewalFee currency="#CURRENCY#">#RENEWAL FEE#</tld:renewalFee>
        <tld:reactivateEnabled>#REACTIVATE ENABLED#</tld:reactivateEnabled>
        <tld:reactivateFee currency="#CURRENCY#">#REACTIVATE FEE#</tld:reactivateFee>
        <tld:claims beginDate="#BEGIN DATE#" endDate="#END DATE#">#CLAIMS#</tld:claims>
    </resData>
</response>

<resData> (Occurences: 1)
R #TLD# Top level domain (COM per example)
R #CATEGORY# The category the TLD belongs to (GTLD/CCTLD/NGTLD)
R #COUNTRY# The country/regions the TLD belongs to
R #MINIMUM SUBSCRIPTION PERIOD# The minimum number of years a domain can be registered
R #MAXIMUM SUBSCRIPTION PERIOD# The maximum number of years a domain can be registered
R #INCREMENT SUBSCRIPTION PERIOD# Add a multiplier of this value to the minimum subscription period to increase the final subscription period
R #REGISTRATION DELAY# Time it takes to register a domain (Text format)
R #MINIMUM RENEW PERIOD# The minimum number of years a domain can be renewed
R #MAXIMUM RENEW PERIOD# The maximum number of years a domain can be renewed
R #RENEW BEFORE EXPIRATION# The number of days before expiration a domain in auto-renew mode will begin its renew process
R #MINIMUM CHAR ALLOWED# The minimum number of char allowed for a domain name
R #MAXIMUM CHAR ALLOWED# The maximum number of char allowed for a domain name
R #HYPHEN ALLOWED# Information whether usage of hyphen character "-" is allowed or not (YES/NO)
R #NUMBER ALLOWED# Information whether usage of numerical characters are allowed or not (YES/NO)
R #LOCAL ORG REQUIRED# Specifies whether local organisation contact is required or not
R #LOCAL ADMIN REQUIRED# Specifies whether local administrative contact is required or not
R #LOCAL TECH CONTACT REQUIRED# Specifies whether local technical contact is required or not
R #LOCAL BILLING REQUIRED# Specifies whether local billing contact is required or not
R #INCREMENT RENEW PERIOD# Add a multiplier of this value to the minimum renewal period to increase the final renewal period
R #SETUP FEE# Setup fee (Discount included)
R #CURRENCY# The currency of the returned amount
R #ANNUAL FEE# Annual fee (Discount included)
R #CURRENCY# The currency of the returned amount
R #MODIFICATION FEE# Modification fee (Discount included)
R #CURRENCY# The currency of the returned amount
R #TRADE ENABLED# Information whether we currently offer the possibility to perform trades or not (YES/NO)
R #TRANSFER ENABLED# Information whether a domain may be Transferred to EuroDNS (YES/NO)
R #TRANSFER OUT ENABLED# Information whether a domain may be Transferred from EuroDNS (YES/NO)
R #UPDATE ENABLED# Information whether a domain may be updated (YES/NO)
R #UPDATE O CONTACT ALLOWED# Information whether the organisational contact may be updated (YES/NO)
R #UPDATE A CONTACT ALLOWED# Information whether the administrative contact may be updated (YES/NO)
R #UPDATE T CONTACT ALLOWED# Information whether the technical contact may be updated (YES/NO)
R #UPDATE B CONTACT ALLOWED# Information whether the billing contact may be updated (YES/NO)
R #UPDATE LICENSEE NEED TRADE# Updating licesee need trade operation (YES/NO)
R #TRADE FEE# Trade fee (Discount included)
R #CURRENCY# The currency of the returned amount
R #TRADE REQUIRED# Information whether a trade is required to update the organisational contact (licensee) of the domain or not (YES/NO)
R #TRADE FIELDS# List of the fields of the organisational contact that can only be modified by performing a trade
R #TRANSFER FEE# Fee for transfers to EuroDNS (Discount included)
R #CURRENCY# The currency of the returned amount
R #TRANSFER NUMBER OF FREE YEARS# Number of free years included in the transfer fee
R #TRANSFER NEED AUTHCODE# Information whether an authcode is required for transfers or not (YES/NO).
R #TRANSFERTRADE ENABLED# Information whether a transfer/trade is required for transfers or not (YES/NO).
R #LOCKING ENABLED# Information whether a domain may be locked or not (YES/NO)
R #RESTRICTED# Information whether the TLD is restricted or not (YES/NO)
R #ADDITIONAL INFORMATION# Additional information (Restrictions, Promotions...)
R #DNSSEC# Information whether a tld has a dnssec or not (YES/NO)
R #IDN# Information whether the TLD has an idn or not (YES/NO)
R #NEED ADDITIONAL INFO NEW# Need additional information for new (YES/NO)
R #NEED ADDITIONAL INFO UPDATE# Need additional info for update (YES/NO)
R #NEED ADDITIONAL INFO TRANSFER# Need additional info for transfer (YES/NO)
R #NEED ADDITIONAL INFO TRADE# Need additional info for trade (YES/NO)
R #NEED ADDITIONAL INFO SUNRISE# Need additional info for sunrise (YES/NO)
R #NEED CONTACT VALIDATION# Need contact validation (YES/NO)
R #TRANSFER NEED SIGNED DOC# Information wether signed document is required upon transfer (YES/NO)
R #UPDATE NS ALLOWED# Information wether nameservers may be updated (YES/NO)
R #RENEWAL METHOD# Renewal Method (AUTORENEW, AUTOEXPIRE)
R #RENEWAL FEE# Fee for renewal (Discounts included)
R #CURRENCY# The currency of the returned amount
R #REACTIVATE ENABLED# Information wether domains may be reactivated (YES/NO)
R #REACTIVATE FEE# Fee for domain reactivation (Discount included)
R #CURRENCY# The currency of the returned amount
R #CLAIMS# Information whether the tld is currently in claim period or not (YES/NO)
O #BEGIN DATE# Begin date of claim period - ISO 8601 format
O #END DATE# End date of claim period - ISO 8601 format