Domains
Get domain by ID
Returns detailed information about a specific domain.
The response includes:
- Full domain details
- Active nameservers
- DNS provider information
- All associated tags
- All mailboxes belonging to this domain
get/api/v1/domains/{domainId}
Request
- Base URL: https://api.aerosend.io
- URL: https://api.aerosend.io/api/v1/domains/{domainId}
- Auth: API key in header X-API-Key
Path parameters
domainIdinteger required
Domain ID
Response
Successfully retrieved domain
Example response
{
"success": true,
"data": {
"id": 123,
"domain_tld": "example.com",
"mail_domain": "mail",
"status": "active",
"is_warmup": true,
"warmup_start_date": "2025-12-01T00:00:00Z",
"warmup_end_date": "2025-12-22T00:00:00Z",
"mailbox_count": 5,
"redirect_url": "https://example.com",
"attached_at": "2025-11-01T10:30:00Z",
"dns_provider": {
"id": 1,
"name": "Cloudflare"
},
"mailboxes": [
{
"id": 456,
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"status": "active",
"created_at": "2025-12-01T10:30:00Z",
"updated_at": "2025-12-10T15:45:00Z",
"domain_id": 123,
"domain": "example.com",
"credentials": {
"smtp": {
"host": "smtp.topdeliverabilityninja.com",
"port": 587,
"username": "john@example.com",
"security": "TLS"
},
"imap": {
"host": "smtp.topdeliverabilityninja.com",
"port": 587,
"username": "john@example.com",
"security": "TLS"
}
},
"tags": [
{
"id": 789,
"name": "client-abc",
"display_name": "Client ABC",
"color": "#000369",
"status": "active",
"domain_count": 10,
"mailbox_count": 45,
"created_at": "2025-12-01T10:30:00Z",
"updated_at": "2025-12-10T15:45:00Z"
}
]
}
],
"tags": [
{
"id": 789,
"name": "client-abc",
"display_name": "Client ABC",
"color": "#000369",
"status": "active",
"domain_count": 10,
"mailbox_count": 45,
"created_at": "2025-12-01T10:30:00Z",
"updated_at": "2025-12-10T15:45:00Z"
}
]
},
"timestamp": "2025-12-14T10:30:00Z"
}Changes
No recorded changes to this operation across all 1 revision of this API.