Get one tracking domain

Search Documentation

Search across all developer documentation

entities

Get one tracking domain

GET /v1/tracking-domains/{domain}
Auth required api.tracking.view

Returns one tracking domain by its full subdomain string. Match is case-insensitive. dns_records always starts with the tracking subdomain's CNAME (pointing at the SendOps redirect host), followed by the SES DKIM CNAMEs — all of them must be published for verification to succeed. Returns 404 not_found when the domain is not registered with this org.

Path parameters

domain string required

Tracking subdomain (case-insensitive).

Responses

Errors follow the RFC 7807 problem format — see the error reference.

200 Tracking domain detail application/json
domain string required

Tracking subdomain, e.g. track.example.com.

status string enum required

Coalesced verification state. verified requires both DNS-record verification and the SES identity to be verified; failed covers DNS-failed and DNS-invalid sub-states; otherwise pending.

One of: pending, verified, failed

ssl_status string enum required

active when HTTPS is provisioned for the tracking host; inactive for HTTP-only.

One of: active, inactive

dns_records array<object> required

DNS records the customer must publish for verification to succeed. The first record is the tracking subdomain's CNAME (pointing at the SendOps redirect host); the remaining records are the SES DKIM CNAMEs.

Each entry in dns_records:

type string required
name string required
value string required
created_at string<date-time> required
verified_at string<date-time> | null required

Time of the most recent successful verification. null until the first verification passes.

401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
422 Query parameter or path value failed validation application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json