---
title: "Get custom tracking status"
method: GET
path: "/v1/email/domains/{id}/custom-tracking"
tags: ["Email"]
---

# Get custom tracking status

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

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/email/domains/{id}/custom-tracking`
- Auth: API key in header `x-api-key`

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.

## Path parameters

- `id` string, required

## Response `200`

CustomTrackingStatus

- CustomTrackingStatus
  - `enabled` boolean, required
  - `customTracking` object, nullable, required
    - `status` 'pending' | 'caa-blocked' | 'active' | 'teardown-scheduled' | 'disabled', required
    - `label` string, required
    - `hostname` string, required
    - `region` string, required
    - `sslStatus` string, nullable, required
    - `certificate` CustomTrackingCertificate, required
      - `reason` object, required
        - `code` 'initializing' | 'awaiting-hostname' | 'awaiting-dcv' | 'issuing' | 'caa-blocked' | 'validation-error' | 'timed-out' | 'verifying-route' | 'ready' | 'provider-unreachable', required
        - `message` string, required
      - `lastCheckedAt` string, nullable, required
      - `nextCheckAt` string, nullable, required
    - `dnsRecords` object, required
      - `tracking` CustomTrackingDnsRecord, required
        - `name` string, required
        - `type` string, required
        - `value` string, required
      - `dcvDelegation` CustomTrackingDnsRecord, required
        - `name` string, required
        - `type` string, required
        - `value` string, required
    - `caaBlocked` boolean, required
    - `verificationErrors` string[], required
    - `teardownScheduledAt` string, nullable, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `404`: ResourceNotFoundError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

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