curl https://api.bouncy.ai/v1/domains \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/domains', {
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
});
const { domains, systemDomains } = await response.json();
console.log(`You have ${domains.length} custom domains`);
domains.forEach(domain => {
console.log(`${domain.domain} - ${domain.status}`);
});
console.log(`${systemDomains.length} system domains available`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/domains',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
data = response.json()
print(f"You have {data['count']} custom domains")
for domain in data['domains']:
print(f"{domain['domain']} - {domain['status']}")
{
"domains": [
{
"domain": "go.example.com",
"status": "VERIFIED",
"isSubdomain": true,
"rootDomain": "example.com",
"subdomainPart": "go",
"vercelState": "ready",
"dnsRecords": [
{ "type": "CNAME", "host": "go", "value": "cname.vercel-dns.com" }
],
"createdAt": "2026-01-15T10:00:00Z",
"verifiedAt": "2026-01-15T10:30:00Z"
}
],
"count": 1,
"defaultDomain": "bouncy.ai",
"systemDomains": [
{ "domain": "tapmy.social", "premium": true },
{ "domain": "mybouncy.link", "premium": true }
]
}
Domains
List Domains
List your custom domains and the domains every account can use
GET
/
v1
/
domains
curl https://api.bouncy.ai/v1/domains \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/domains', {
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
});
const { domains, systemDomains } = await response.json();
console.log(`You have ${domains.length} custom domains`);
domains.forEach(domain => {
console.log(`${domain.domain} - ${domain.status}`);
});
console.log(`${systemDomains.length} system domains available`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/domains',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
data = response.json()
print(f"You have {data['count']} custom domains")
for domain in data['domains']:
print(f"{domain['domain']} - {domain['status']}")
{
"domains": [
{
"domain": "go.example.com",
"status": "VERIFIED",
"isSubdomain": true,
"rootDomain": "example.com",
"subdomainPart": "go",
"vercelState": "ready",
"dnsRecords": [
{ "type": "CNAME", "host": "go", "value": "cname.vercel-dns.com" }
],
"createdAt": "2026-01-15T10:00:00Z",
"verifiedAt": "2026-01-15T10:30:00Z"
}
],
"count": 1,
"defaultDomain": "bouncy.ai",
"systemDomains": [
{ "domain": "tapmy.social", "premium": true },
{ "domain": "mybouncy.link", "premium": true }
]
}
Request
Headers
Response
array
Custom domains connected to your account
Show properties
Show properties
string
Domain name
string
VERIFIED (or ACTIVE) when links and websites can use it; PENDING_VERIFICATION until its DNS records are in placeboolean
Whether the domain is a subdomain (e.g.
go.example.com)string
The registrable domain (e.g.
example.com)string
The subdomain label (e.g.
go), or nullstring
Provisioning state of the domain’s hosting
array
DNS records to add at your DNS provider, each with
type, host and valuestring
Timestamp of connection
string
Timestamp of verification (absent until verified)
integer
Number of custom domains
string
The domain a link uses when none is given:
bouncy.aiarray
curl https://api.bouncy.ai/v1/domains \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch('https://api.bouncy.ai/v1/domains', {
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
});
const { domains, systemDomains } = await response.json();
console.log(`You have ${domains.length} custom domains`);
domains.forEach(domain => {
console.log(`${domain.domain} - ${domain.status}`);
});
console.log(`${systemDomains.length} system domains available`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/domains',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
data = response.json()
print(f"You have {data['count']} custom domains")
for domain in data['domains']:
print(f"{domain['domain']} - {domain['status']}")
{
"domains": [
{
"domain": "go.example.com",
"status": "VERIFIED",
"isSubdomain": true,
"rootDomain": "example.com",
"subdomainPart": "go",
"vercelState": "ready",
"dnsRecords": [
{ "type": "CNAME", "host": "go", "value": "cname.vercel-dns.com" }
],
"createdAt": "2026-01-15T10:00:00Z",
"verifiedAt": "2026-01-15T10:30:00Z"
}
],
"count": 1,
"defaultDomain": "bouncy.ai",
"systemDomains": [
{ "domain": "tapmy.social", "premium": true },
{ "domain": "mybouncy.link", "premium": true }
]
}