---
title: "Get domain details"
method: GET
path: "/tenants/{tenantId}/domains/{domainId}"
tags: ["Domains"]
---

# Get domain details

`GET /tenants/{tenantId}/domains/{domainId}`

Get detailed information about a domain including DNS record status.

## Path parameters

- `tenantId` string, required
- `domainId` string, required

## Response `200`

Domain details

- DomainResponse
  - `success` true, required
  - `data` object, required
    - `id` integer, required — Unique domain identifier
    - `uuid` string, uuid, required — UUID of the domain
    - `name` string, required — The domain name used for sending emails
    - `verified` boolean, required — Whether all DNS records (SPF, DKIM, Return Path) are correctly configured. Domain must be verified before sending emails.
    - `verifiedAt` string, date-time, nullable — Timestamp when the domain ownership was verified, or null if not yet verified
    - `dnsRecords` object, nullable, required — DNS records that must be added to your domain's DNS settings. Null if records are not yet generated. **Important:** The `name` field contains the relative hostname that you should enter in your DNS provider. Most DNS providers auto-append the zone name, so you only need to enter the relative part. For subdomains like `mail.example.com`, the zone is `example.com`, so: - SPF `name` would be `mail` (not `@`) - DKIM `name` would be `ark-xyz._domainkey.mail` - Return Path `name` would be `psrp.mail`
      - `zone` string — The DNS zone (registrable domain) where records should be added. This is the root domain that your DNS provider manages. For `mail.example.com`, the zone is `example.com`. For `example.co.uk`, the zone is `example.co.uk`.
      - `spf` DnsRecord — A DNS record that needs to be configured in your domain's DNS settings. The `name` field contains the relative hostname to enter in your DNS provider (which auto-appends the zone). The `fullName` field contains the complete fully-qualified domain name (FQDN) for reference. **Example for subdomain `mail.example.com`:** - `name`: `"mail"` (what you enter in DNS provider) - `fullName`: `"mail.example.com"` (the complete hostname) **Example for root domain `example.com`:** - `name`: `"@"` (DNS shorthand for apex/root) - `fullName`: `"example.com"`
        - `type` 'TXT' | 'CNAME' | 'MX', required — The DNS record type to create
        - `name` string, required — The relative hostname to enter in your DNS provider. Most DNS providers auto-append the zone name, so you only need to enter this relative part. - `"@"` means the apex/root of the zone (for root domains) - `"mail"` for a subdomain like `mail.example.com` - `"ark-xyz._domainkey.mail"` for DKIM on a subdomain
        - `fullName` string, required — The complete fully-qualified domain name (FQDN). Use this as a reference to verify the record is configured correctly.
        - `value` string, required — The value to set for the DNS record
        - `status` 'OK' | 'Missing' | 'Invalid' | 'null', nullable — Current verification status of this DNS record: - `OK` - Record is correctly configured and verified - `Missing` - Record was not found in your DNS - `Invalid` - Record exists but has an incorrect value - `null` - Record has not been checked yet
      - `dkim` DnsRecord — A DNS record that needs to be configured in your domain's DNS settings. The `name` field contains the relative hostname to enter in your DNS provider (which auto-appends the zone). The `fullName` field contains the complete fully-qualified domain name (FQDN) for reference. **Example for subdomain `mail.example.com`:** - `name`: `"mail"` (what you enter in DNS provider) - `fullName`: `"mail.example.com"` (the complete hostname) **Example for root domain `example.com`:** - `name`: `"@"` (DNS shorthand for apex/root) - `fullName`: `"example.com"`
        - `type` 'TXT' | 'CNAME' | 'MX', required — The DNS record type to create
        - `name` string, required — The relative hostname to enter in your DNS provider. Most DNS providers auto-append the zone name, so you only need to enter this relative part. - `"@"` means the apex/root of the zone (for root domains) - `"mail"` for a subdomain like `mail.example.com` - `"ark-xyz._domainkey.mail"` for DKIM on a subdomain
        - `fullName` string, required — The complete fully-qualified domain name (FQDN). Use this as a reference to verify the record is configured correctly.
        - `value` string, required — The value to set for the DNS record
        - `status` 'OK' | 'Missing' | 'Invalid' | 'null', nullable — Current verification status of this DNS record: - `OK` - Record is correctly configured and verified - `Missing` - Record was not found in your DNS - `Invalid` - Record exists but has an incorrect value - `null` - Record has not been checked yet
      - `returnPath` DnsRecord — A DNS record that needs to be configured in your domain's DNS settings. The `name` field contains the relative hostname to enter in your DNS provider (which auto-appends the zone). The `fullName` field contains the complete fully-qualified domain name (FQDN) for reference. **Example for subdomain `mail.example.com`:** - `name`: `"mail"` (what you enter in DNS provider) - `fullName`: `"mail.example.com"` (the complete hostname) **Example for root domain `example.com`:** - `name`: `"@"` (DNS shorthand for apex/root) - `fullName`: `"example.com"`
        - `type` 'TXT' | 'CNAME' | 'MX', required — The DNS record type to create
        - `name` string, required — The relative hostname to enter in your DNS provider. Most DNS providers auto-append the zone name, so you only need to enter this relative part. - `"@"` means the apex/root of the zone (for root domains) - `"mail"` for a subdomain like `mail.example.com` - `"ark-xyz._domainkey.mail"` for DKIM on a subdomain
        - `fullName` string, required — The complete fully-qualified domain name (FQDN). Use this as a reference to verify the record is configured correctly.
        - `value` string, required — The value to set for the DNS record
        - `status` 'OK' | 'Missing' | 'Invalid' | 'null', nullable — Current verification status of this DNS record: - `OK` - Record is correctly configured and verified - `Missing` - Record was not found in your DNS - `Invalid` - Record exists but has an incorrect value - `null` - Record has not been checked yet
    - `createdAt` string, date-time, required — Timestamp when the domain was added
    - `tenant_id` string — ID of the tenant this domain belongs to
    - `tenant_name` string — Name of the tenant this domain belongs to
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

- `401` — Invalid or missing API key
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/versions/98a90852ffca/schema)