Skip to Content

Get custom tracking status

Returns the custom tracking state for a sending domain: lifecycle status, the required DNS records, certificate and CAA readiness, and any scheduled teardown.

GET
/v1/email/domains/{id}/custom-tracking

Returns the custom tracking state for a sending domain: lifecycle status, the required DNS records, certificate and CAA readiness, and any scheduled teardown. enabled is false when no custom tracking domain is provisioned.

Authorization

apiKey
headerx-api-key<token>

Path Parameters

id*string
Match^dom_[0-9a-hjkmnp-tv-z]{16,24}$

Response Body

CustomTrackingStatus

application/json
  1. response
enabled*boolean
customTracking*|null
parentDomains*array<string>
Example Request
import { createClient } from "samva";

const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });

const result = await samva.email.getCustomTracking({
  "id": "example"
});
Example Response
{
  "enabled": true,
  "customTracking": {
    "status": "pending",
    "label": "string",
    "hostname": "string",
    "parentDomain": "string",
    "region": "string",
    "sslStatus": "string",
    "certificate": {
      "reason": {
        "code": "initializing",
        "message": "string"
      },
      "lastCheckedAt": "string",
      "nextCheckAt": "string"
    },
    "dnsRecords": {
      "tracking": {
        "name": "string",
        "type": "string",
        "value": "string"
      },
      "dcvDelegation": {
        "name": "string",
        "type": "string",
        "value": "string"
      }
    },
    "caaBlocked": true,
    "verificationErrors": [
      "string"
    ],
    "teardownScheduledAt": "string"
  },
  "parentDomains": [
    "string"
  ]
}

Related documentation