---
title: "GET /v1/workspaces/{workspaceId}/sending-domains"
method: GET
path: "/v1/workspaces/{workspaceId}/sending-domains"
---

# GET /v1/workspaces/{workspaceId}/sending-domains

`GET /v1/workspaces/{workspaceId}/sending-domains`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/sending-domains`
- Auth: HTTP bearer

## Response `200`

Banger-native sending domains for the workspace.

- object
  - `data` NativeSendingDomain[], required
    - `domain_id` string, uuid, required
    - `product_id` string, uuid, required
    - `root_domain` string, required
    - `parent_domain` string: Company domain retained when a lane uses a subdomain.
    - `setup_mode` 'simple' | 'advanced'
    - `domain_status` 'pending' | 'verified' | 'failed' | 'disabled' | 'deleting' | 'deleted', required
    - `lanes` NativeSendingLane[], required
      - `id` string, uuid, required
      - `created_at` string, date-time
      - `kind` 'mailbox' | 'product' | 'broadcast', required
      - `display_name` string, required
      - `from_domain` string, required
      - `mail_from_domain` string, nullable, required
      - `inbound_domain` string, nullable, required
      - `route_provider` 'banger' | 'resend', required
      - `selected_provider_connection_id` string, uuid, nullable, required
      - `inbound_provider` 'banger' | 'null', nullable, required
      - `status` 'pending' | 'active' | 'paused' | 'deleting' | 'deleted', required
      - `status_reason` string, nullable, required
      - `desired_revision` integer, required
      - `observed_revision` integer, required
      - `dns_ready` boolean, required
      - `provider_ready` boolean, required
      - `inbound_ready` boolean, required
      - `outbound_ready` boolean, required
      - `banger_transport_ready` boolean, required
      - `banger_mail_from_domain` string, nullable, required
      - `provisioning_job_id` string, uuid, nullable, required
      - `provisioning_status` 'pending' | 'provisioning' | 'waiting_dns' | 'active' | 'failed' | 'deleting' | 'deleted' | 'not_required', required
      - `provisioning_error_code` string, nullable
      - `provisioning_next_attempt_at` string, nullable
      - `provisioning_last_checked_at` string, nullable
      - `provider_identity_status` string, nullable
      - `provider_dkim_status` string, nullable
      - `dns_records` NativeSendingDnsRecord[], required
        - `id` string, uuid, required
        - `lane_id` string, uuid, required
        - `provider` 'banger' | 'resend', required
        - `purpose` string, required
        - `type` 'TXT' | 'MX' | 'CNAME', required
        - `name` string, required
        - `value` string, required
        - `priority` integer, nullable, required
        - `required` boolean, required
        - `status` 'pending' | 'verified' | 'error', required
        - `provider_status` 'pending' | 'verified' | 'error' | 'not_applicable', required
        - `first_observed_at` string, date-time, nullable, required
        - `last_checked_at` string, date-time, nullable, required
        - `error` object, required
        - `provider_reference` string, nullable, required
    - `dns_records` NativeSendingDnsRecord[], required
      - `id` string, uuid, required
      - `lane_id` string, uuid, required
      - `provider` 'banger' | 'resend', required
      - `purpose` string, required
      - `type` 'TXT' | 'MX' | 'CNAME', required
      - `name` string, required
      - `value` string, required
      - `priority` integer, nullable, required
      - `required` boolean, required
      - `status` 'pending' | 'verified' | 'error', required
      - `provider_status` 'pending' | 'verified' | 'error' | 'not_applicable', required
      - `first_observed_at` string, date-time, nullable, required
      - `last_checked_at` string, date-time, nullable, required
      - `error` object, required
      - `provider_reference` string, nullable, required
    - `deletion` object, nullable, required
      - `job_id` string, uuid, required
      - `status` 'pending' | 'processing' | 'waiting_provider' | 'completed' | 'failed', required
      - `last_error_code` string, nullable, required
      - `cleanup_records` NativeSendingDnsRecord[], required: Exact DNS records the user may remove after teardown completes.
        - `id` string, uuid, required
        - `lane_id` string, uuid, required
        - `provider` 'banger' | 'resend', required
        - `purpose` string, required
        - `type` 'TXT' | 'MX' | 'CNAME', required
        - `name` string, required
        - `value` string, required
        - `priority` integer, nullable, required
        - `required` boolean, required
        - `status` 'pending' | 'verified' | 'error', required
        - `provider_status` 'pending' | 'verified' | 'error' | 'not_applicable', required
        - `first_observed_at` string, date-time, nullable, required
        - `last_checked_at` string, date-time, nullable, required
        - `error` object, required
        - `provider_reference` string, nullable, required

---

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