curl --request GET \
--url https://api.social-api.ai/v1/inbox/conversations \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/inbox/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/inbox/conversations"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"account_id": "<string>",
"created_at": "<string>",
"id": "<string>",
"last_message": "<string>",
"last_message_at": "<string>",
"page_id": "<string>",
"participant_id": "<string>",
"participant_name": "<string>",
"participant_picture": "<string>",
"platform": "<string>",
"platform_id": "<string>",
"status": "<string>",
"unread_count": 123,
"updated_at": "<string>",
"user_id": "<string>"
}
],
"last_synced_at": "<string>",
"pagination": {
"has_more": true,
"next_cursor": "<string>"
},
"sync_state": "idle"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}List inbox conversations
Returns paginated DM conversations for the authenticated user, optionally filtered by account, platform, and status.
curl --request GET \
--url https://api.social-api.ai/v1/inbox/conversations \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/inbox/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/inbox/conversations"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"account_id": "<string>",
"created_at": "<string>",
"id": "<string>",
"last_message": "<string>",
"last_message_at": "<string>",
"page_id": "<string>",
"participant_id": "<string>",
"participant_name": "<string>",
"participant_picture": "<string>",
"platform": "<string>",
"platform_id": "<string>",
"status": "<string>",
"unread_count": 123,
"updated_at": "<string>",
"user_id": "<string>"
}
],
"last_synced_at": "<string>",
"pagination": {
"has_more": true,
"next_cursor": "<string>"
},
"sync_state": "idle"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Authorizations
Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...
Query Parameters
Filter by connected account ID
Filter by brand ID (returns only conversations from accounts in this brand)
Filter by Facebook/Instagram page ID (for multi-page accounts)
Filter by platform (instagram, facebook, …)
Conversation status: active (default) or archived
active, archived Max results (1–100, default 25)
Pagination cursor from previous response
Response
Paginated list of conversations
Show child attributes
Show child attributes
Show child attributes
Show child attributes
SyncState is "idle", "syncing", or "failed" for this account's conversation-list sync. Reading it never triggers a sync, and a client that ignores it sees exactly the previous response.
idle, syncing, failed "idle"