Get custom domain

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

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

fetch('https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}"

	req, _ := http.NewRequest("GET", 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}")

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

request = Net::HTTP::Get.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:00",
  "last_status_payload": {
    "verificationStatus": "verified"
  },
  "redirect_target_domain": "www.example.com",
  "provider_id": "wix"
}

Custom domains

Get custom domain

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

Returns one custom domain by ID.

This reads Base44’s stored copy of the domain and never contacts the hosting provider, so last_status_check and last_status_payload are only as current as the last status check that ran. Use Get custom domain status when you need the provider’s answer now.

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

GET

api

apps

{app_id}

custom-domains

{domain_id}

Get custom domain

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

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

fetch('https://app.base44.com/api/apps/{app_id}/custom-domains/{domain_id}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  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}"

	req, _ := http.NewRequest("GET", 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}")

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

request = Net::HTTP::Get.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:00",
  "last_status_payload": {
    "verificationStatus": "verified"
  },
  "redirect_target_domain": "www.example.com",
  "provider_id": "wix"
}

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. Get this from List custom domains.

Response

The domain.

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 to lower case 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 stays attached to the app and keeps its DNS, 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, as a UTC timestamp in ISO 8601 format, or null if it never has.

Example:

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

last_status_payload

CustomDomainStatusPayload · object | null

The provider's last report on the domain, or null until a status check has run.

Show child attributes

redirect_target_domain

string | null

The domain that visitors to this one are sent to with a 301 redirect. The value is null when this domain 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. The value is null otherwise, which covers both a domain you own elsewhere and one bought through the Entri flow, so this isn't a purchased-versus-external signal.

Example:

"wix"

Base44 APIs

Apps API (Beta)

Monitoring API

Audit Logs API

Get custom domain

Authorizations

Path Parameters

Response