Domain info

Check domain availability and other infos

This endpoint builds on top of the WHOIS data. It normalizes fields between TLDs, formats data to the same format and returns the most accurate data after checking both Registry and Registrar WHOIS.

Use this endpoint to get availability, registrant, status and more detailed info.

GET https://domains-api.com/domains/{domain}

Path Parameters

Name
Type
Description

domain*

String

Valid domain name

Query Parameters

Name
Type
Description

mode

String

detailed, standard, cache

apiKey

String

Your API Key

Headers

Name
Type
Description

Authorization

String

Your API Key

Domain object

{
    "domain": "exmaple.com",
    "keyword": "exmaple",
    "tld": "com",
    "availability": "registered",
    "status": [
        "clientDeleteProhibited",
        "clientTransferProhibited",
        "clientUpdateProhibited"
    ],
    "ns": [
        "ara.ns.cloudflare.com",
        "jay.ns.cloudflare.com"
    ],
    "dates": {
        "created": "2004-10-08T13:53:42.000Z",
        "updated": "2023-03-19T11:04:50.000Z",
        "expiry": "2032-10-08T13:53:42.000Z",
        "expiryDays": 3291
    },
    "registrar": {
        "url": "http://www.cloudflare.com",
        "name": "CloudFlare, Inc.",
        "whois": "whois.cloudflare.com"
    },
    "contacts": {
        "registrant": {
            "name": null,
            "organization": null,
            "email": null,
            "phone": null,
            "street": null,
            "city": null,
            "postalCode": null,
            "state": null,
            "country": null
        },
        "admin": {
            "name": null,
            "organization": null,
            "email": null,
            "phone": null,
            "street": null,
            "city": null,
            "postalCode": null,
            "state": null,
            "country": null
        },
        "tech": {
            "name": null,
            "organization": null,
            "email": null,
            "phone": null,
            "street": null,
            "city": null,
            "postalCode": null,
            "state": null,
            "country": null
        },
        "billing": {
            "name": null,
            "organization": null,
            "email": null,
            "phone": null,
            "street": null,
            "city": null,
            "postalCode": null,
            "state": null,
            "country": null
        }
    },
    "whois": {
        ...whois data
    }
}

Examples

const domain = 'ai.com'

fetch(`https://domains-api.com/domain/${domain}`, {
        headers: {
            Authorizaton: `Bearer _api_key_`
        }
    })
    .then(response => response.json())
    .then(domainInfo => {
        console.log('Domain:', domainInfo.domain)
        console.log('Availability:', domainInfo.availability)
        console.log('Important dates:', domainInfo.dates)
    })

Last updated

Was this helpful?