---
title: "Get a sending domain"
method: GET
path: "/v1/email/domains/{id}"
tags: ["Email"]
---

# Get a sending domain

`GET /v1/email/domains/{id}`

## Request

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

Returns a single sending domain, including its DNS records and verification details.

## Path parameters

- `id` string, required

## Response `200`

EmailDomainDetailed

- EmailDomainDetailed
  - `id` string, required
  - `domain` string, required
  - `phase` 'dns-setup' | 'provisioning' | 'verifying' | 'ready' | 'degraded' | 'failed', required
  - `dkimSelector` string, nullable
  - `dkimPublicKey` string, nullable
  - `dnsRecords` object[], required
    - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'NS' | 'SOA' | 'PTR' | 'SRV' | 'TXT' | 'CAA', required
    - `name` string, required
    - `value` string, required
    - `ttl` string, nullable
    - `description` string, nullable
    - `priority` integer, nullable
  - `verifiedAt` string, nullable, required
  - `namespaceId` string, required
  - `isDefault` boolean, required
  - `deliverability` DeliverabilityFacts, required: Bounce and complaint rates over the last 24 hours, as fractions between 0 and 1, with `windowSends`, the deliveries they were divided by, plus `sendingStatus`, which says whether the organization can currently send. The window matches the one the sending-pause rule reads. Below 200 sends that rule ignores the window entirely, so a rate over a smaller `windowSends` is a quotient rather than a reading. These are not a lifetime record; an identity with no traffic in the window reports zeroes.
    - `bounceRate` number, required
    - `complaintRate` number, required
    - `windowSends` integer, required
    - `sendingStatus` 'enabled' | 'disabled' | 'reinstated' | 'unknown', required
  - `createdAt` string, required
  - `updatedAt` string, 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)