---
title: "Get domain by ID"
method: GET
path: "/api/v1/domains/{domainId}"
tags: ["Domains"]
---

# Get domain by ID

`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`

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

## Path parameters

- `domainId` integer, required

## Response `200`

Successfully retrieved domain

- DomainResponse
  - `success` boolean: Success flag
  - `data` Domain: Domain details
    - `id` integer: Domain ID
    - `domain_tld` string: Full domain name including TLD
    - `mail_domain` string: Mail domain prefix
    - `status` string: Domain status
    - `is_warmup` boolean: Whether domain is in warmup
    - `warmup_start_date` string: Warmup start date
    - `warmup_end_date` string: Warmup end date
    - `mailbox_count` integer: Number of mailboxes used
    - `redirect_url` string: Domain redirect URL
    - `attached_at` string: Date domain was attached
    - `nameservers` string[]: Active nameservers for the domain
    - `dns_provider` DnsProvider: DNS provider information
      - `id` integer: Provider ID
      - `name` string: Provider name
    - `mailboxes` Mailbox[]: Mailboxes belonging to this domain (if requested)
      - `id` integer: Mailbox ID
      - `email` string: Email address
      - `first_name` string: First name
      - `last_name` string: Last name
      - `status` string: Mailbox status
      - `created_at` string: Creation timestamp
      - `updated_at` string: Last modification timestamp
      - `domain_id` integer: Domain ID this mailbox belongs to
      - `domain` string: Domain name
      - `credentials` Credentials: SMTP and IMAP credentials for mailbox
        - `smtp` ServerConfig: Mail server configuration
          - `host` string: Server hostname
          - `port` integer: Server port
          - `username` string: Username (email address)
          - `password` string: Password for authentication
          - `security` string: Security protocol
        - `imap` ServerConfig: Mail server configuration
          - `host` string: Server hostname
          - `port` integer: Server port
          - `username` string: Username (email address)
          - `password` string: Password for authentication
          - `security` string: Security protocol
      - `tags` Tag[]: Tags assigned to this mailbox
        - `id` integer: Tag ID
        - `name` string: Normalized tag name
        - `display_name` string: Display name
        - `color` string: Tag color in hex
        - `status` string: Tag status
        - `domain_count` integer: Number of domains with this tag
        - `mailbox_count` integer: Number of mailboxes with this tag
        - `created_at` string: Creation timestamp
        - `updated_at` string: Last update timestamp
    - `tags` Tag[]: Tags assigned to this domain
      - `id` integer: Tag ID
      - `name` string: Normalized tag name
      - `display_name` string: Display name
      - `color` string: Tag color in hex
      - `status` string: Tag status
      - `domain_count` integer: Number of domains with this tag
      - `mailbox_count` integer: Number of mailboxes with this tag
      - `created_at` string: Creation timestamp
      - `updated_at` string: Last update timestamp
  - `timestamp` string: Response timestamp

## Other responses

- `401`: Unauthorized - Invalid or expired API key
- `404`: Domain not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/aerosend/apis/aerosend-developer-api.md) · [All operations](https://skmtc.dev/aerosend/apis/aerosend-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aerosend/apis/aerosend-developer-api/revisions/9828eeb89b1f?raw)