Skip to main content
GET
/
inbox
/
conversations
List inbox conversations
curl --request GET \
  --url https://api.social-api.ai/v1/inbox/conversations \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "created_at": "2026-03-20T09:00:00Z",
      "id": "conv_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "last_message": "Thanks for reaching out!",
      "last_message_at": "2026-03-27T10:30:00Z",
      "participant_id": "17841405793187999",
      "participant_name": "John Doe",
      "participant_picture": "https://example.com/pic.jpg",
      "platform": "instagram",
      "platform_id": "17841405793187218",
      "status": "active",
      "unread_count": 2,
      "updated_at": "2026-03-27T10:30:00Z",
      "user_id": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 25,
    "next_cursor": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Query Parameters

​
account_id
string

Filter by connected account ID

​
platform
string

Filter by platform (instagram, facebook, …)

​
status
enum<string>

Conversation status: active (default) or archived

Available options:
active,
archived
​
limit
integer

Max results (1–100, default 25)

​
cursor
string

Pagination cursor from previous response

Response

Paginated list of conversations

​
data
object[]
​
pagination
object