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

# List conversations

`GET /api/conversations`

## Request

- Base URL: `https://api.supovia.com`
- URL: `https://api.supovia.com/api/conversations`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Lists the conversations of your organization, newest first when sorted by `lastEditTime`. Requires the `conversations:read` scope.

## Query parameters

- `websiteId` string
- `customerId` string
- `limit` integer
- `skip` integer
- `sortField` string
- `sortDirection` 'ASC' | 'DESC'
- `resolved` boolean
- `spam` boolean
- `inboxFilter` 'all' | 'unread' | 'unresolved' | 'resolved' | 'mentions' | 'spam'
- `conversationFilter` 'all' | 'last-hour' | 'today' | 'last-week' | 'online'
- `timezone` string
- `fields` string

## Response `200`

Array of conversations, or { conversations, total, filteredTotal } when inboxFilter is supplied

## Other responses

- `401`: Missing or invalid credentials
- `403`: API key is missing the `conversations:read` scope
- `429`: API key rate limit exceeded

---

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