> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Tracking Domain

> Get the tracking domain every sending domain uses

Get your company tracking domain: the one hostname every sending domain uses
for tracked links and opens, such as `links.example.com`. It never blocks
sending. While it is missing, unverified, broken or removed, links use
Sequenzy's shared tracking domain.

Requires the `account:read` scope.

## Request

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/tracking-domain" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response fields

<ResponseField name="trackingDomain" type="object | null">
  The company tracking domain, or `null` when links use the shared Sequenzy
  tracking domain.
</ResponseField>

<ResponseField name="trackingDomain.domain" type="string">
  The tracking hostname.
</ResponseField>

<ResponseField name="trackingDomain.status" type="string">
  `not_started`, `pending`, `verified` or `failed`. It covers both the CNAME and
  the HTTPS certificate. `not_started` means the DNS setup was not confirmed or
  checked yet.
</ResponseField>

<ResponseField name="trackingDomain.active" type="boolean">
  `true` while verified. New emails use this domain only while it is active.
</ResponseField>

<ResponseField name="trackingDomain.everVerified" type="boolean">
  `true` once this hostname has verified. A `failed` domain that verified before
  is broken; one that never verified is an unfinished setup.
</ResponseField>

<ResponseField name="trackingDomain.sslStatus" type="string | null">
  HTTPS certificate status reported by the tracking provider.
</ResponseField>

<ResponseField name="trackingDomain.verifiedAt" type="string | null">
  When it last became verified.
</ResponseField>

<ResponseField name="trackingDomain.lastCheckedAt" type="string | null">
  When it was last checked.
</ResponseField>

<ResponseField name="trackingDomain.error" type="string | null">
  The latest verification problem, if any.
</ResponseField>

<ResponseField name="trackingDomain.cnameRecord" type="object">
  The record to publish: `type` (`CNAME`), `name` and `value`. Turn off proxying
  for it.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "trackingDomain": {
      "domain": "links.example.com",
      "status": "verified",
      "active": true,
      "everVerified": true,
      "sslStatus": "active",
      "verifiedAt": "2026-09-28T11:00:00Z",
      "lastCheckedAt": "2026-09-28T12:00:00Z",
      "error": null,
      "cnameRecord": {
        "type": "CNAME",
        "name": "links.example.com",
        "value": "links1.sequenzydns.com"
      }
    }
  }
  ```

  ```json 200 (none set) theme={null}
  {
    "success": true,
    "trackingDomain": null
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 403 theme={null}
  {
    "success": false,
    "error": "API key is missing required scope: account:read"
  }
  ```
</ResponseExample>