---
title: "List Inbox Groups"
method: GET
path: "/api/inbox/groups"
tags: ["inbox"]
---

# List Inbox Groups

`GET /api/inbox/groups`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/inbox/groups`
- 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`

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `order` 'priority' | 'newest'
- `status` 'all' | 'unread' | 'needs_reply' | 'replied'
- `channels` ConversationChannel[]
- `sender_account_ids` string[]
- `sequence_ids` string[]
- `search` string, nullable
- `date_preset` 'today' | '7d' | '30d' | '90d' | 'all', nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `reply_categories` ConversationReplyCategory[]
- `buckets` ConversationIntelligenceBucket[]
- `priority_bands` ConversationPriorityBand[]
- `urgencies` ConversationUrgency[]
- `recommended_actions` ConversationRecommendedAction[]

## Response `200`

Successful Response

- ConversationGroupListResponse
  - `counts` ConversationListCountsPayload, required
    - `needs_reply_groups` integer, required
    - `total_groups` integer, required
    - `unread_groups` integer, required
  - `groups` ConversationGroupListItemPayload[], required
    - `group` ConversationGroupPayload, required
      - `active_channels` ConversationChannel[], required
      - `avatar_url` string, nullable, required
      - `company_name` string, nullable, required
      - `conversation_group_id` integer, required
      - `display_name` string, nullable, required
      - `inbound_message_count` integer, required
      - `last_channel` 'email' | 'linkedin', required
      - `last_inbound_at` string, date-time, nullable, required
      - `last_message_at` string, date-time, required
      - `last_message_preview` string, required
      - `last_outbound_at` string, date-time, nullable, required
      - `latest_thread_id` integer, nullable, required
      - `linkedin_url` string, nullable, required
      - `message_count` integer, required
      - `needs_reply` boolean, required
      - `person_id` integer, required
      - `primary_email` string, nullable, required
      - `reply_sender_account_ids` string[], required
      - `sequence_ids` string[], required
      - `updated_at` string, date-time, required
      - `version` integer, required
    - `intelligence` ConversationIntelligenceCurrentPayload, required
      - `analysis_version` string, required
      - `bucket` 'needs_reply' | 'waiting' | 'resolved' | 'noise', required
      - `confidence` number, nullable, required
      - `evidence_message_ids` integer[], required
      - `extracted_objections` string[], required
      - `input_hash` string, nullable, required
      - `labels` string[], required
      - `next_steps` string[], required
      - `priority_band` 'hot' | 'warm' | 'neutral' | 'cold', required
      - `priority_score` integer, nullable, required
      - `reason` string, nullable, required
      - `recommended_action` 'reply_now' | 'book_meeting' | 'answer_question' | 'route_to_owner' | 'wait' | 'suppress' | 'ignore' | 'manual_review', required
      - `reply_category` 'meeting_requested' | 'positive_interest' | 'pricing_or_procurement' | 'technical_or_security_question' | 'objection' | 'not_now' | 'not_interested' | 'targeting_mismatch' | 'wrong_person_or_referral' | 'unsubscribe_or_dnc' | 'delivery_failed' | 'delivery_delayed' | 'auto_reply' | 'support_or_existing_customer' | 'neutral_or_unclear', required
      - `response_sla` 'now' | 'today' | 'this_week' | 'none', required
      - `short_summary` string, nullable, required
      - `source_last_message_at` string, date-time, nullable, required
      - `source_message_count` integer, nullable, required
      - `source_version` integer, nullable, required
      - `status` 'pending' | 'running' | 'completed' | 'failed_retryable' | 'failed_permanent' | 'superseded' | 'not_applicable', required
      - `target_source_last_message_at` string, date-time, required
      - `target_source_message_count` integer, required
      - `target_source_version` integer, required
      - `updated_at` string, date-time, required
      - `urgency` 'urgent' | 'high' | 'normal' | 'low', required
      - `urgency_reason` string, nullable, required
    - `priority_band` 'hot' | 'warm' | 'neutral' | 'cold', required
    - `priority_reason` string, nullable, required
    - `summary_text` string, nullable, required
    - `unread_count` integer, required
  - `next_cursor` string, nullable, required
  - `total_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)