domain:checkclaims

Check for eligibility to claim

To find out whether a domain is eligible for claim or not, you can send the following request to our server. If you specify multiple domains, do not forget to increase the timeout value of your scripts as it may take a couple of seconds before our server will return an answer.

Please note that this service is not available for all top level domains and that the number of daily requests is limited. This limitation is necessary due to the fact that most of the registries limit the number of allowed requests and blacklist IP addresses exceeding this limit.

You can find the number of allowed request in the section Your profile > Allowed requests.

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

<domain:checkclaims> (Occurences: 1)
<domain:name> (Occurences: 1+)
Note: Repeat this section to check multiple domains in one request
R #DOMAIN.TLD# Name of the domain to check

If the action was successful, the following code will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns:domain="http://www.eurodns.com/domain">
    <result code="1000">
        <msg>Command completed successfully</msg>
    </result>
    <resData>
        <domain:checkclaims>
            <domain:cd>
                <domain:name>#DOMAIN.TLD#</domain:name>
                <domain:claimkey>#CLAIM KEY#</domain:claimkey>
                <domain:notice>#NOTICE#</domain:notice>
            </domain:cd>
        </domain:checkclaims>
    </resData>
</response>

If the action was not successful, the following code will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns:domain="http://www.eurodns.com/domain">
    <result code="200">
        <msg>Command failed</msg>
    </result>
    <resData>
        <domain:checkclaims>
            <domain:cd>
                <domain:name>#DOMAIN.TLD#</domain:name>
                <domain:reason code="#CODE#">#STATUS DESCRIPTION#</domain:reason>
            </domain:cd>
        </domain:checkclaims>
    </resData>
</response>

<resData> (Occurences: 1)
<domain:checkclaims> (Occurences: 1)
<domain:cd> (Occurences: 1+)
Note: If multiple domains have been specified, this section will be repeated
R #DOMAIN.TLD# Name of the checked domain
R #CLAIM KEY# The domain claim key
R #NOTICE# The domain XML notice
R #STATUS DESCRIPTION# Description of the returned status