---
title: "List inbox conversations"
method: GET
path: "/api/v1/inbox/conversations"
tags: ["Inbox"]
---

# List inbox conversations

`GET /api/v1/inbox/conversations`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/inbox/conversations`
- Auth: HTTP bearer

List Instagram and Facebook Page DM conversations. Threads has no DMs. Requires posts:read, a Pro plan or higher, and viewer workspace access.

## Query parameters

- `workspace_id` string
- `account_id` integer
- `platform` 'instagram' | 'facebook' | 'threads'
- `filter` 'all' | 'unread' | 'starred' | 'archived'
- `search` string
- `limit` integer
- `offset` integer

## Response `200`

Conversations listed successfully

- object
  - `conversations` object[]
  - `total` integer
  - `hasMore` boolean
  - `workspaces_searched` string[]: Workspace IDs actually searched for this request.
  - `workspaces_skipped` object[]: Workspaces the caller belongs to that were skipped, with why: the workspace owner's plan lacks inbox access, or the caller's role there is below viewer.
    - `workspace_id` string
    - `name` string
    - `reason` 'plan' | 'role'

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `403`: Request is authenticated but not allowed
- `429`: Too many requests

---

[API](https://skmtc.dev/poster/apis/posterly-api.md) · [All operations](https://skmtc.dev/poster/apis/posterly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/poster/apis/posterly-api/revisions/60be02a61f95?raw)