List tracking domains

Search Documentation

Search across all developer documentation

entities

List tracking domains

GET /v1/tracking-domains
Auth required tracking.view

Returns the org's CNAME-based open/click tracking subdomains and the DNS records you need to publish for each. status is a coalesced view across DNS-record verification and SES-identity verification: verified requires both checks to pass; failed covers DNS failures; anything else is pending. verified_at is the time of the last successful verification and stays null until then. This endpoint is read-only — add or remove tracking domains via the SendOps dashboard. Sorted newest-first.

Query parameters

limit integer optional

Page size (1–200). Default 50.

cursor string optional

Opaque cursor returned from the previous page.

Responses

200 Tracking domains, newest-first application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated 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