---
title: "Get Sender Readiness"
method: GET
path: "/api/senders/readiness"
tags: ["senders"]
---

# Get Sender Readiness

`GET /api/senders/readiness`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/senders/readiness`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

Return one bounded readiness response instead of three client round trips.

## Query parameters

- `channel` 'email' | 'linkedin'

## Response `200`

Successful Response

- SenderReadinessPayload: One authoritative sender inventory and capacity snapshot for SDK callers.
  - `account_count` integer, required
  - `blocked_reason` string, nullable
  - `capacity` SenderCapacityPayload, required
    - `assigned_email_capacity` integer, required
    - `assigned_email_mailbox_count` integer, required
    - `assigned_linkedin_account_count` integer, required
    - `assigned_linkedin_capacity` integer, required
    - `connected_email_mailbox_count` integer, required
    - `connected_linkedin_account_count` integer, required
    - `linkedin_daily_capacity` integer, required
    - `linkedin_queued_today` integer, required
    - `linkedin_sent_today` integer, required
    - `queued_today` integer, required
    - `sent_today` integer, required
    - `total_daily_capacity` integer, required
  - `channel` 'email' | 'linkedin'
  - `failed_account_count` integer, required
  - `metrics` SenderOverviewMetricsPayload, required
    - `needs_attention_count` integer, required
    - `total_email_accounts` integer, required
    - `total_linkedin_accounts` integer, required
    - `total_senders` integer, required
  - `pending_account_count` integer, required
  - `ready` boolean, required
  - `sender_count` integer, required
  - `senders` SenderWithAccountsPayload[]
    - `accounts` SenderAccountPayload[]
      - `account_kind` 'mailbox' | 'linkedin_account', required
      - `channel` 'email' | 'linkedin', required
      - `connection_status` 'pending' | 'connected' | 'expired' | 'revoked' | 'error' | 'disconnected', required
      - `created_at` string, date-time, required
      - `created_by_user_id` string, required
      - `daily_send_limit` integer, nullable
      - `domain_id` string, nullable
      - `external_account_id` string, nullable
      - `health_status` 'unknown' | 'healthy' | 'warning' | 'degraded' | 'critical' | 'paused', required
      - `identifier` string, required
      - `is_default` boolean, required
      - `last_synced_at` string, date-time, nullable
      - `metadata` object
      - `organization_uuid` string, required
      - `outbound_readiness` 'ready' | 'warming' | 'partial' | 'paused' | 'blocked', nullable
      - `outbound_readiness_actions` string[]
      - `outbound_readiness_lanes` OutboundReadinessLanePayload[]
        - `action` 'LINKEDIN_CONNECTION_REQUEST' | 'SEND_LINKEDIN_MESSAGE' | 'SEND_INMAIL' | 'LINKEDIN_ANY_OUTBOUND', required
        - `daily_cap` integer, nullable
        - `healthy` boolean, required
        - `label` string, required
        - `reason` string, nullable
        - `stage` 'new' | 'ramping' | 'established' | 'recovery' | 'paused', required
        - `user_action` string, nullable
        - `weekly_cap` integer, nullable
      - `outbound_readiness_reason` string, nullable
      - `outbound_readiness_summary` string, nullable
      - `outbound_readiness_user_action` string, nullable
      - `provider` 'google' | 'microsoft' | 'linkedin' | 'inboxkit' | 'resend' | 'namecheap' | 'cloudflare' | 'manual' | 'other', required
      - `provider_link_id` string, nullable
      - `sender_account_id` string, required
      - `sender_id` string, nullable
      - `status` 'active' | 'archived', required
      - `updated_at` string, date-time, required
      - `updated_by_user_id` string, required
      - `warmup_ramp` WarmupRampPayload
        - `current_cap` integer, nullable
        - `day_index` integer, required
        - `days_remaining` integer, required
        - `disabled` boolean
        - `in_warmup` boolean, required
        - `target_cap` integer, required
      - `warmup_status` 'not_applicable' | 'pending' | 'warming' | 'ready' | 'paused' | 'error', required
    - `provider_links` SenderProviderLinkPayload[]
      - `authorized_by_user_id` string, nullable
      - `created_at` string, date-time, required
      - `external_subject_id` string, nullable
      - `link_kind` 'mailbox_oauth' | 'linkedin_oauth' | 'domain_vendor' | 'mailbox_vendor' | 'other', required
      - `metadata` object
      - `organization_uuid` string, required
      - `provider` 'google' | 'microsoft' | 'linkedin' | 'inboxkit' | 'resend' | 'namecheap' | 'cloudflare' | 'manual' | 'other', required
      - `provider_link_id` string, required
      - `scopes` string[]
      - `secret_ref` string, nullable
      - `status` 'pending' | 'active' | 'expired' | 'revoked' | 'error', required
      - `updated_at` string, date-time, required
    - `sender` SenderPayload, required
      - `calendar_link` string, nullable
      - `created_at` string, date-time, required
      - `created_by_user_id` string, required
      - `display_name` string, nullable
      - `first_name` string, required
      - `last_name` string, required
      - `linked_auth_user_id` string, nullable
      - `linkedin_profile_url` string, nullable
      - `metadata` object
      - `organization_uuid` string, required
      - `primary_email` string, nullable
      - `sender_id` string, required
      - `sending_schedule` SendingSchedulePayload
        - `days_of_week` integer[], required
        - `send_window_end` string, required
        - `send_window_start` string, required
        - `timezone` string, required
      - `status` 'active' | 'archived', required
      - `updated_at` string, date-time, required
      - `updated_by_user_id` string, required
  - `usable_account_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)