---
title: "List sending domains"
method: GET
path: "/v1/email/domains"
tags: ["Email"]
---

# List sending domains

`GET /v1/email/domains`

## Request

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

Returns the organization's sending domains, newest first. A namespace-scoped key lists only its namespace's domains; an organization-wide caller lists every domain, or one namespace's with `namespaceId`. Pass `nextCursor` back as `cursor` for the next page; it is null on the last page. `sendable=true` lists only domains a send can use now: active, and verified, or verified before and degraded since. Each row carries `deliverability` (bounce and complaint rates over the last 24 hours, the window the 5% bounce limit is enforced over) and `series`, the last 14 days of daily email sends attributed to the domain, oldest first.

## Query parameters

- `limit` string, nullable
- `cursor` string
- `sendable` 'true', nullable
- `namespaceId` string

## Response `200`

EmailDomainPage

- EmailDomainPage
  - `items` object[], required
    - `id` string, required
    - `domain` string, required
    - `phase` 'dns-setup' | 'provisioning' | 'verifying' | 'ready' | 'degraded' | 'failed', required
    - `dkimSelector` string, nullable
    - `dkimPublicKey` string, nullable
    - `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
    - `series` integer[], required: Daily email sends for the last 14 calendar days in the organization's own timezone, oldest first and zero-filled. Always fourteen entries; an entity that has never sent reports fourteen zeroes.
    - `createdAt` string, required
    - `updatedAt` string, required
  - `nextCursor` string, nullable, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `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)