Get custom domain status

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status"

headers = {"api_key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "68b1c0d4e7b91d003c45a1f7",
  "domain": "example.com",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "disabled": false,
  "last_status_check": "2026-08-15T09:10:00Z",
  "last_status_payload": {
    "verificationStatus": "verified"
  },
  "redirect_target_domain": "www.example.com",
  "provider_id": "wix"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Get custom domain status

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

Asks the hosting provider whether the domain’s DNS is verified, and returns the domain with the answer written into it.

This is the endpoint to poll while waiting for a domain to go live. It reaches the provider on every call, unlike Get custom domain, which returns Base44’s stored copy. It also writes what it learns, so last_status_check and last_status_payload on the domain are updated as a side effect.

Read last_status_payload.verificationStatus: verified means the domain serves the app, anything else means it does not yet.

Only call this for a domain that is currently linked. A domain that was never linked, or was unlinked, is not attached at the provider, and asking about it fails rather than reporting “not verified”.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

POST

api

apps

{app_id}

custom-domains

{domain_id}

status

Get custom domain status

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status"

headers = {"api_key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "68b1c0d4e7b91d003c45a1f7",
  "domain": "example.com",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "disabled": false,
  "last_status_check": "2026-08-15T09:10:00Z",
  "last_status_payload": {
    "verificationStatus": "verified"
  },
  "redirect_target_domain": "www.example.com",
  "provider_id": "wix"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app the domain belongs to.

domain_id

string

required

ID of the custom domain, as returned in id by List custom domains.

Response

The domain, with the provider's answer written into its status fields.

A custom domain attached to an app.

string

required

ID of the domain. Pass it as domain_id to the other domain endpoints.

Example:

"68b1c0d4e7b91d003c45a1f7"

domain

string

required

The domain name, normalized: lower-cased, with any scheme, trailing slash and leading www. removed.

Example:

"example.com"

app_id

string

required

ID of the app the domain serves.

Example:

"6820f3a4e7b91d003c45a1f2"

disabled

boolean

required

Whether Base44 has stopped serving the domain. A disabled domain keeps its DNS and its row, and serves a placeholder page instead of the app.

Example:

false

last_status_check

string<date-time> | null

When Get custom domain status last ran for this domain, or null if it never has.

Example:

"2026-08-15T09:10:00Z"

last_status_payload

CustomDomainStatusPayload · object | null

The provider's last report on the domain, or null until a status check has run. Only verificationStatus is part of this API; the provider sends other keys and they can change.

Show child attributes

redirect_target_domain

string | null

The domain this one 301-redirects to, or null when it serves the app itself.

Example:

"www.example.com"

provider_id

string | null

Names the registrar when the domain was bought through Base44's Wix flow. null otherwise, which covers both a domain you own elsewhere and one bought through the Entri flow, so this is not a purchased-versus-external signal.

Example:

"wix"

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Get custom domain status

Authorizations

Path Parameters

Response