messages
List conversations
Fetch conversations (DMs) from all connected messaging accounts in a single API call. Supports filtering by profile and platform. Results are aggregated and deduplicated. Supported platforms: Facebook, Instagram, Twitter/X, Bluesky, Reddit, Telegram.
AuthorizationBearer <token>
API key authentication - use your Late API key as a Bearer token
In: header
Query Parameters
profileId?string
Filter by profile ID
platform?string
Filter by platform
Value in
"facebook" | "instagram" | "twitter" | "bluesky" | "reddit" | "telegram"status?string
Filter by conversation status
Value in
"active" | "archived"sortOrder?string
Sort order by updated time
Default
"desc"Value in
"asc" | "desc"limit?integer
Maximum number of conversations to return
Default
50Range
1 <= value <= 100cursor?string
Pagination cursor for next page
accountId?string
Filter by specific social account ID
Response Body
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/inbox/conversations"{
"data": [
{
"id": "string",
"platform": "string",
"accountId": "string",
"accountUsername": "string",
"participantId": "string",
"participantName": "string",
"participantPicture": "string",
"lastMessage": "string",
"updatedTime": "2019-08-24T14:15:22Z",
"status": "active",
"unreadCount": 0,
"url": "string",
"instagramProfile": {
"isFollower": true,
"isFollowing": true,
"followerCount": 0,
"isVerified": true,
"fetchedAt": "2019-08-24T14:15:22Z"
}
}
],
"pagination": {
"hasMore": true,
"nextCursor": "string"
},
"meta": {
"accountsQueried": 0,
"accountsFailed": 0,
"failedAccounts": [
{
"accountId": "string",
"accountUsername": "string",
"platform": "string",
"error": "string",
"code": "string",
"retryAfter": 0
}
],
"lastUpdated": "2019-08-24T14:15:22Z"
}
}{
"error": "Unauthorized"
}Empty