Check the availability of one or more domains

Check if a domain name is available for purchase. You can check multiple domains at once.

GET /domains/status

Go

Go

package main

import(
	"context"
	dubgo "github.com/dubinc/dub-go"
	"github.com/dubinc/dub-go/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := dubgo.New(
        dubgo.WithSecurity("DUB_API_KEY"),
    )

    res, err := s.Domains.CheckStatus(ctx, operations.CheckDomainStatusRequest{
        Domains: operations.CreateDomainsStr(
            "<value>",
        ),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

200

[
  {
    "domain": "<string>",
    "available": true,
    "price": "<string>",
    "premium": true
  }
]

Checking a domain availability requires an Enterprise plan

Authorizations

Authorization · string · header · required

Default authentication mechanism

Query Parameters

domains · string string[] · required

The domains to search. We only support .link domains for now.

Response

200

application/json

The domain status was retrieved.

domain · string · required

The domain name.

available · boolean · required

Whether the domain is available.

price · string | null · required

The price description.

premium · boolean | null · required

Whether the domain is a premium domain.