---
title: "Get an inbox conversation"
method: GET
path: "/api/v1/inbox/conversations/{id}"
tags: ["Inbox"]
---

# Get an inbox conversation

`GET /api/v1/inbox/conversations/{id}`

## Request

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

Get one DM conversation and its messages. Returns 404 if it is not in the workspace. Requires posts:read, a Pro plan or higher, and viewer workspace access.

## Path parameters

- `id` string, required

## Query parameters

- `workspace_id` string
- `limit` integer

## Response `200`

Conversation fetched successfully

- object
  - `conversation` object
  - `messages` object[]

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `403`: Request is authenticated but not allowed
- `404`: Resource not found
- `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)