Check domain availability

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Checks whether a domain can be registered through Base44, and suggests similar ones.

The first entry in results is always the domain you asked about, followed by up to five suggestions. A premium domain, or one containing a social media platform's name, comes back as unavailable because Base44 can't sell it.

The check asks Wix, so it fails while Wix's domain search is unavailable. Retrying later is safe.

Checking is limited to 12 requests a minute per caller. Some workspaces have a different limit.

get/api/apps/{app_id}/custom-domains/availability

Path parameters

app_idstring required

ID of the app you're finding a domain for.

ID of the app you're finding a domain for.

Query parameters

domainstring required

Domain to check, such as example.com.

Domain to check, such as example.com.

Response

Successful Response

querystring required

The domain you asked about, normalized to lower case.

Example response

{
  "query": "nordwind-furniture.com",
  "results": [
    {
      "domain": "nordwind-furniture.com",
      "available": true,
      "reason": "premium"
    }
  ]
}

Changes

Changed in 1 of the 14 revisions of this API.1