Get Tracking Domain

GET

api

tracking-domain

Get Tracking Domain

curl --request GET \
  --url https://api.sequenzy.com/api/v1/tracking-domain \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/tracking-domain', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/tracking-domain",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/tracking-domain"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/tracking-domain")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
    }
  }
}

{
  "success": true,
  "trackingDomain": null
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

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. Use this to confirm whether your workspace uses a custom tracking domain: new emails use it only when trackingDomain.active is true. See Confirm which tracking domain is in use. Requires the account:read scope.

Request

curl "https://api.sequenzy.com/api/v1/tracking-domain" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response fields

object | null

The company tracking domain, or null when links use the shared Sequenzy tracking domain.

string

The tracking hostname.

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.

boolean

true while verified. New emails use this domain only while it is active.

boolean

true once this hostname has verified. A failed domain that verified before is broken; one that never verified is an unfinished setup.

string | null

HTTPS certificate status reported by the tracking provider.

string | null

When it last became verified.

string | null

When it was last checked.

string | null

The latest verification problem, if any.

object

The record to publish: type (CNAME), name and value. Turn off proxying for it.

{
  "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"
    }
  }
}

{
  "success": true,
  "trackingDomain": null
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

Get Tracking Domain

curl --request GET \
  --url https://api.sequenzy.com/api/v1/tracking-domain \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/tracking-domain', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/tracking-domain",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/tracking-domain"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/tracking-domain")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
    }
  }
}

{
  "success": true,
  "trackingDomain": null
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}