---
title: "List inbox conversations"
method: GET
path: "/inbox/{inboxId}"
tags: ["Social Inbox"]
---

# List inbox conversations

`GET /inbox/{inboxId}`

## Request

- Base URL: `https://socialbu.com/api/v1`
- URL: `https://socialbu.com/api/v1/inbox/{inboxId}`
- Auth: HTTP bearer

Returns paginated conversations for an account or team inbox.

## Path parameters

- `inboxId` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `status` 'open' | 'pending' | 'closed' | 'spam'
- `post_id` string
- `assigned_to` string
- `start` string, date-time
- `end` string, date-time
- `item_types` string[]
- `account_types[]` string[]
- `unread` boolean
- `q` string

## Response `200`

Conversations retrieved successfully.

- InboxPaginatedConversationsResponse
  - `items` InboxConversation[]
    - `id` integer: Conversation ID.
    - `type` string, nullable: Network-specific conversation type.
    - `options` object, nullable: Network-specific conversation options.
    - `external_id` string, nullable: Platform-specific conversation ID.
    - `contact` object, nullable: Social contact details, when available.
    - `latest` object, nullable: Latest inbox item snapshot.
    - `account` object, nullable: Social account attached to the conversation.
    - `status` 'open' | 'pending' | 'closed' | 'spam': Conversation status.
    - `content` string, nullable: Conversation text preview.
    - `attachments` object[]: Conversation attachments.
    - `tags` string[]: Conversation tag names.
    - `created_at` string, date-time: When the conversation was created.
    - `latest_at` string, date-time: Time of the latest conversation activity.
    - `assigned_to` object, nullable: Assigned user, when assigned.
    - `creator_account` object, nullable: Creator account for networks that expose it.
  - `currentPage` integer: Current page number.
  - `lastPage` integer: Last available page number.
  - `nextPage` integer, nullable: Next page number, or null when this is the last page.
  - `total` integer: Total number of matching conversations.

## Other responses

- `404`: Inbox not found or not available to the authenticated user.
- `422`: The given data was invalid.

---

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