import { CommuneClient } from 'commune-ai';
const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });
const domain = await commune.domains.get('domain_xyz789');
console.log(domain.data.status); // verified
console.log(domain.data.records); // DNS records
from commune import CommuneClient
client = CommuneClient()
domain = client.domains.get("domain_xyz789")
print(domain.data.status)
get_domain(id="domain_xyz789")
curl "https://api.commune.email/v1/domains/domain_xyz789" \
-H "Authorization: Bearer comm_..."
commune domains get domain_xyz789
{
"data": {
"id": "domain_xyz789",
"name": "mycompany.com",
"status": "verified",
"region": "us-east-1",
"records": [
{
"type": "MX",
"name": "mycompany.com",
"value": "feedback-smtp.us-east-1.amazonses.com",
"priority": 10,
"ttl": 300,
"status": "verified"
},
{
"type": "TXT",
"name": "resend._domainkey.mycompany.com",
"value": "p=MIGfMA0GCSq...",
"ttl": 300,
"status": "verified"
}
],
"createdAt": "2026-02-01T08:00:00.000Z"
}
}
{
"error": "Domain not found"
}
{
"error": "unauthorized",
"message": "Invalid or missing API key"
}
Domains
Get domain
Retrieve details for a single domain including DNS records and verification status.
GET
/
v1
/
domains
/
:domainId
import { CommuneClient } from 'commune-ai';
const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });
const domain = await commune.domains.get('domain_xyz789');
console.log(domain.data.status); // verified
console.log(domain.data.records); // DNS records
from commune import CommuneClient
client = CommuneClient()
domain = client.domains.get("domain_xyz789")
print(domain.data.status)
get_domain(id="domain_xyz789")
curl "https://api.commune.email/v1/domains/domain_xyz789" \
-H "Authorization: Bearer comm_..."
commune domains get domain_xyz789
{
"data": {
"id": "domain_xyz789",
"name": "mycompany.com",
"status": "verified",
"region": "us-east-1",
"records": [
{
"type": "MX",
"name": "mycompany.com",
"value": "feedback-smtp.us-east-1.amazonses.com",
"priority": 10,
"ttl": 300,
"status": "verified"
},
{
"type": "TXT",
"name": "resend._domainkey.mycompany.com",
"value": "p=MIGfMA0GCSq...",
"ttl": 300,
"status": "verified"
}
],
"createdAt": "2026-02-01T08:00:00.000Z"
}
}
{
"error": "Domain not found"
}
{
"error": "unauthorized",
"message": "Invalid or missing API key"
}
import { CommuneClient } from 'commune-ai';
const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });
const domain = await commune.domains.get('domain_xyz789');
console.log(domain.data.status); // verified
console.log(domain.data.records); // DNS records
from commune import CommuneClient
client = CommuneClient()
domain = client.domains.get("domain_xyz789")
print(domain.data.status)
get_domain(id="domain_xyz789")
curl "https://api.commune.email/v1/domains/domain_xyz789" \
-H "Authorization: Bearer comm_..."
commune domains get domain_xyz789
{
"data": {
"id": "domain_xyz789",
"name": "mycompany.com",
"status": "verified",
"region": "us-east-1",
"records": [
{
"type": "MX",
"name": "mycompany.com",
"value": "feedback-smtp.us-east-1.amazonses.com",
"priority": 10,
"ttl": 300,
"status": "verified"
},
{
"type": "TXT",
"name": "resend._domainkey.mycompany.com",
"value": "p=MIGfMA0GCSq...",
"ttl": 300,
"status": "verified"
}
],
"createdAt": "2026-02-01T08:00:00.000Z"
}
}
{
"error": "Domain not found"
}
{
"error": "unauthorized",
"message": "Invalid or missing API key"
}
Path Parameters
string
required
The domain ID to retrieve. Obtain this from List domains or Create domain.
Response
object
Hide properties
Hide properties
string
Unique domain identifier.
string
The registered domain name.
string
Verification status.
"pending" or "verified". Only verified domains can send and receive email.string
AWS region for this domain’s sending infrastructure.
object[]
DNS records required for domain verification.
Show Record properties
Show Record properties
string
DNS record type (e.g.
MX, TXT, CNAME).string
DNS record name/host to set at your registrar.
string
DNS record value to set.
number
MX record priority. Only present for MX records.
number
Recommended TTL in seconds.
string
Verification status for this record. One of:
not_started, pending, verified, failed.string
ISO 8601 creation timestamp.
Last modified on March 19, 2026
Was this page helpful?

