---
title: "List conversations"
method: GET
path: "/conversations"
tags: ["Conversations"]
---

# List conversations

`GET /conversations`

## Request

- Base URL: `https://api.weav.com/v1`
- URL: `https://api.weav.com/v1/conversations`
- Auth: HTTP bearer

## Query parameters

- `per_page` integer
- `page` integer
- `status` 'open' | 'closed'
- `channel` 'email' | 'chat'

## Response `200`

Success

- object
  - `data` Conversation[]
    - `id` string, uuid
    - `channel` 'email' | 'chat'
    - `customer_id` string, uuid
    - `subject` string, nullable
    - `status` 'open' | 'closed'
    - `priority` 'low' | 'normal' | 'high' | 'urgent'
    - `assignee_id` string, uuid, nullable: ID of the assigned user or agent. Assignees must belong to the same workspace. Chat conversations can only use the original chat agent when assigning an agent. Email conversations can only use the active email agent when assigning an agent.
    - `assignee_type` 'user' | 'agent', nullable: Type of assignee: 'user' for users or 'agent' for AI agents.
    - `closed_at` string, date-time, nullable
    - `first_response_at` string, date-time, nullable
    - `last_message_at` string, date-time, nullable
    - `is_spam` boolean
    - `spam_score` number, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized

---

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