Tld:info

Obtaining additional information about a top-level domain

Not all top-level domains follow the same rules. For example, most have a minimum subscription period of one year. However, some require at least two years. For specific information about a top-level domain, 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 > (Occurrences: 1)

< tld:name > (Occurrences: 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>

< tld:list > (Occurrences: 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 #HYPHEN 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

Legend

O The element is optional and does not have to be specified in the request and/or answer
R The element is mandatory and has to specifed in the request and/or answer