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
Custom domains connected to your account
Show properties
Show properties
VERIFIED (or ACTIVE) when links and websites can use it; PENDING_VERIFICATION until its DNS records are in placecurl 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 }
]
}