Get the domain check status

Request Information
URL GET {{basepath}}/domainCheck/:domainname?noCache=yes
CategoryDomainCheck

Description

With this you can check if a domain is available or not. It also provides the premium status. Results are cached for 3 minutes

You can provide more than one domain at a time (CSV) and IDN format (Punycode)

Returns a DomaincheckWithPremiumResponse object.

Query parameters
noCacheyesonly set this to yes when you reaaaaaally need uncached results.(final checkout time) otherwise please use cache
Url variables
:domainnamegerman.online,example.com

Example responses

Get the domain check status
Request Method & URL
GET {{basepath}}/domainCheck/:domainname
Url variables
:domainnamegerman.school
Response Code:
200 OK
Response Body:
{
    "responseId": "mapi1_e1480b3bd9506973aa70d95b02c4477cf7afe3fb",
    "status": "ok",
    "message": "your results are attached",
    "results": [
        {
            "domainname": "german.school",
            "status": "available_premium"
        }
    ]
}
Multiple domains
Request Method & URL
GET {{basepath}}/domainCheck/:domainname
Url variables
:domainnamegerman.school,test.xyz
Response Code:
200 OK
Response Body:
{
    "responseId": "mapi1_9cf954dcd03a7cad1558962c3fd25be8373733a8",
    "status": "ok",
    "message": "your results are attached",
    "results": [
        {
            "domainname": "german.school",
            "status": "available_premium"
        },
        {
            "domainname": "test.xyz",
            "status": "unavailable"
        }
    ]
}
Get the domain check status
Request Method & URL
GET {{basepath}}/domainCheck/:domainname
Url variables
:domainnametest.notatld
Response Code:
200 OK
Response Body:
{
    "responseId": "mapi1_ce37e7d2cdbe44d65b2825079199d68eb7e74a35",
    "status": "ok",
    "message": "your results are attached",
    "results": [
        {
            "domainname": "test.notatld",
            "status": "unknown"
        }
    ]
}
domain available
Request Method & URL
GET {{basepath}}/domainCheck/:domainname
Url variables
:domainnametest2023-10-24-aaaaaaa.nl
Response Code:
200 OK
Response Body:
{
    "responseId": "mapi1_b5bb235eb5fde656192a38d08e0f779963af6458",
    "status": "ok",
    "message": "your results are attached",
    "results": [
        {
            "domainname": "test2023-10-24-aaaaaaa.nl",
            "status": "available"
        }
    ]
}
Disabled cache with sale info
Request Method & URL
GET {{basepath}}/domainCheck/:domainname?noCache=yes
Query parameters
noCacheyesonly set this to yes when you reaaaaaally need uncached results.(final checkout time) otherwise please use cache
Url variables
:domainnamegerman.online,example.com
Response Code:
200 OK
Response Body:
{
    "responseId": "mapi1_c126af7b0df2f1f82de9d72fda80205c9a5dcd75",
    "status": "ok",
    "message": "your results are attached",
    "results": [
        {
            "domainname": "german.online",
            "status": "available_premium"
        },
        {
            "domainname": "example.com",
            "status": "unavailable",
            "forSale": true,
            "salePrice": 133.7,
            "saleCurrency": "EUR",
            "saleWhereToBuy": "https:\/\/mijndomein.nl\/tekoop\/example.com"
        }
    ]
}