---
title: "The workspace's tracking domain"
method: GET
path: "/api/v1/tracking-domain"
tags: ["Workspace"]
---

# The workspace's tracking domain

`GET /api/v1/tracking-domain`

## Request

- Base URL: `https://mailcheer.com`
- URL: `https://mailcheer.com/api/v1/tracking-domain`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

The domain that carries the links and pixel of the workspace's emails (`click.your-domain.com`), its status and the DNS records to add. `hostname` is `null` until one is declared. No particular permission is required.

## Response `200`

The tracking domain.

- object
  - `object` 'tracking_domain'
  - `hostname` string, nullable
  - `status` string, nullable: pending_dns, verifying, issuing_certificate, active or failed.
  - `active` boolean
  - `reason` string, nullable
  - `detail` string, nullable
  - `dns_records` object[]
    - `type` string
    - `name` string
    - `value` string
    - `required` boolean
  - `links_origin` string, nullable: The address that links and the pixel of new emails carry today.
  - `created_at` string, date-time, nullable
  - `activated_at` string, date-time, nullable
  - `last_checked_at` string, date-time, nullable

---

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