---
title: "List stored social conversations"
method: GET
path: "/messages"
tags: ["Messaging"]
---

# List stored social conversations

`GET /messages`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/messages`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Query parameters

- `workspace_id` string, required
- `platform` string
- `account_id` string
- `archived` boolean
- `limit` integer
- `offset` integer
- `cursor` string: Opaque cursor for stable older-page pagination

## Response `200`

OK

- ConversationPage
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` Conversation[], nullable, required
    - `archived_at` string, date-time
    - `counterpart_avatar_url` string, required
    - `counterpart_handle` string, required
    - `counterpart_name` string, required
    - `counterpart_remote_id` string, required
    - `created_at` string, date-time, required
    - `id` string, required
    - `last_message_at` string, date-time, required
    - `last_message_preview` string, required
    - `last_remote_message_id` string, required
    - `messaging_window_expires_at` string, date-time
    - `platform` string, required
    - `read_at` string, date-time
    - `remote_conversation_id` string, required
    - `social_account_id` string, required
    - `unread_count` integer, required
    - `updated_at` string, date-time, required
    - `workspace_id` string, required
  - `next_cursor` string
  - `sync_states` MessageSyncState[], nullable, required
    - `error_code` string, required
    - `error_message` string, required
    - `id` string, required
    - `last_success_at` string, date-time
    - `next_sync_at` string, date-time
    - `platform` string, required
    - `social_account_id` string, required
    - `status` string, required
  - `total` integer, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)