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

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

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

## Request

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

Configured lanes and effective routing for the default sender. Product and Broadcast inherit the default Mail connection until a dedicated lane is active. Pending lanes do not replace the working route.

## Response `200`

Canonical lanes, inherited routes, and the existing default sender.

- object
  - `data` EmailLaneSurface, required
    - `domains` 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
    - `routing` object, required
      - `mailbox` EffectiveEmailRoute, required
        - `kind` 'mailbox' | 'product' | 'broadcast', required
        - `lane_id` string, nullable, required
        - `domain_id` string, nullable, required
        - `from_domain` string, nullable, required
        - `source` 'dedicated' | 'default_mail' | 'unavailable', required
        - `ready` boolean, required
        - `pending_lanes` object[], required
          - `id` string, required
          - `from_domain` string, required
          - `status` string, required
      - `product` EffectiveEmailRoute, required
        - `kind` 'mailbox' | 'product' | 'broadcast', required
        - `lane_id` string, nullable, required
        - `domain_id` string, nullable, required
        - `from_domain` string, nullable, required
        - `source` 'dedicated' | 'default_mail' | 'unavailable', required
        - `ready` boolean, required
        - `pending_lanes` object[], required
          - `id` string, required
          - `from_domain` string, required
          - `status` string, required
      - `broadcast` EffectiveEmailRoute, required
        - `kind` 'mailbox' | 'product' | 'broadcast', required
        - `lane_id` string, nullable, required
        - `domain_id` string, nullable, required
        - `from_domain` string, nullable, required
        - `source` 'dedicated' | 'default_mail' | 'unavailable', required
        - `ready` boolean, required
        - `pending_lanes` object[], required
          - `id` string, required
          - `from_domain` string, required
          - `status` string, required
    - `default_sender` Mailbox, required
      - `id` string, uuid, required
      - `workspace_id` string, uuid, required
      - `product_id` string, uuid, nullable: The product (project) the mailbox belongs to. Clients group mailboxes and build web-app links with it.
      - `domain_id` string, uuid, nullable
      - `address` string, required: The email address, or for an SMS inbox its phone number in E.164 (+15551234567).
      - `display_name` string, required
      - `provider` 'gmail' | 'smtp' | 'twilio', required
      - `channel` 'email' | 'sms' | 'whatsapp': email; sms for an SMS inbox on Twilio; whatsapp for a WhatsApp inbox, a WhatsApp sender on Twilio for the business's WhatsApp Business account.
      - `sms_verification` object, nullable: A number from Banger, carriers' answer on its toll-free verification. It sends once approved; null for every other mailbox.
        - `status` 'pending_review' | 'in_review' | 'approved' | 'rejected'
        - `reason` string, nullable: Carriers' reason when rejected.
      - `status` 'pending' | 'active' | 'suspended' | 'reconnect_required' | 'disabled', required
      - `status_reason` string, nullable
      - `suspended_at` string, nullable
      - `mailbox_kind` 'domain' | 'starter', 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)