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

# List threads

`GET /conversations`

## Request

- Base URL: `https://rcs-templates-api-dot-msg2ai-server.ue.r.appspot.com/api/agent`
- URL: `https://rcs-templates-api-dot-msg2ai-server.ue.r.appspot.com/api/agent/conversations`
- Auth: HTTP bearer

The org's conversation threads, one per phone number, newest activity first. Archived threads are hidden. Filter by free text, unread, unassigned, a named assignee, or the campaign a thread was messaged in.

## Query parameters

- `search` string
- `unread` boolean
- `unassigned` boolean
- `assignedTo` string
- `broadcastId` string
- `page` number
- `pageSize` number

## Response `200`

Success.

- object

## Other responses

- `400`: Arguments failed validation.
- `401`: Missing or invalid agent key.
- `403`: Key does not hold the conversations:read scope.
- `429`: Rate limited.

---

[API](https://skmtc.dev/rcs-campaigns/apis/rcs-campaigns-agent-gateway.md) · [All operations](https://skmtc.dev/rcs-campaigns/apis/rcs-campaigns-agent-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/rcs-campaigns/apis/rcs-campaigns-agent-gateway/revisions/acdbf292d9d6?raw)