---
title: "Verify track domain DNS"
method: POST
path: "/tenants/{tenantId}/tracking/{trackingId}/verify"
tags: ["Tracking"]
---

# Verify track domain DNS

`POST /tenants/{tenantId}/tracking/{trackingId}/verify`

## Request

- Base URL: `https://api.arkhq.io/v1`
- URL: `https://api.arkhq.io/v1/tenants/{tenantId}/tracking/{trackingId}/verify`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/arkhq-io/apis/ark-email-api/docs/tenants/:tenantId/tracking/:trackingId/verify/post.ts> (a function with typed inputs; its response is checked against the schema)

Check DNS configuration for the track domain.

The track domain requires a CNAME record to be configured before
open and click tracking will work. Use this endpoint to verify
the DNS is correctly set up.

## Response `200`

DNS verification result

- TrackDomainVerifyResponse
  - `success` true, required
  - `data` object, required
    - `id` string, required: Track domain ID
    - `fullName` string, required: Full domain name
    - `dnsOk` boolean, required: Whether DNS is correctly configured
    - `dnsStatus` 'ok' | 'missing' | 'invalid' | 'null', nullable, required: Current DNS verification status
    - `dnsError` string, nullable: DNS error message if verification failed
    - `dnsCheckedAt` string, date-time, nullable: When DNS was last checked
    - `dnsRecord` object, nullable: Required DNS record configuration
      - `type` string
      - `name` string
      - `value` string
  - `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

## Changes

- **2026-02-08** `37bce0c9a4d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/arkhq-io/apis/ark-email-api/changes/tenants/:tenantId/tracking/:trackingId/verify/post.md)

---

[API](https://skmtc.dev/arkhq-io/apis/ark-email-api.md) - [All operations](https://skmtc.dev/arkhq-io/apis/ark-email-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arkhq-io/apis/ark-email-api/revisions/98a90852ffca?raw)