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

successboolean

Success flag

timestampstring

Response timestamp

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.