Merges messages from several conversations into one timeline, grouped by minute (up to 200 groups per page). Pass the returned next token to get the following page.
POST
/conversation/compare
curl \
--request POST 'http://api.example.com/conversation/compare' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "organization: string" \
--data '{
"case": "string",
"caseSlug": "string",
"conversations": [
"string"
],
"startDate": "2026-05-04T09:42:00Z",
"endDate": "2026-05-04T09:42:00Z",
"sortDirection": "asc",
"nextToken": "string"
}'
Request examples
# Headers
organization: string
# Payload
{
"case": "string",
"caseSlug": "string",
"conversations": [
"string"
],
"startDate": "2026-05-04T09:42:00Z",
"endDate": "2026-05-04T09:42:00Z",
"sortDirection": "asc",
"nextToken": "string"
}
Response examples (200)
{
"data": {
"next": "eyJkYXRlIjoiMjAyNi0wMS0xNVQxNDozMTowMC4wMDBaIn0",
"data": [
{
"_id": "2026-05-04T09:42:00Z",
"date": "2026-05-04T09:42:00Z",
"count": 3,
"messages": [
{
"text": "See you at 6",
"tags": [
{
"name": "Important",
"nameLowercase": "important"
}
],
"deviceType": "ios",
"sender": {
"fullName": "Jane Doe",
"firstName": "Jane",
"phoneNational": [
"(555) 555-0100"
],
"avatar": {
"name": "IMG_0001.HEIC",
"convertedName": "IMG_0001_display.png",
"transferState": 5,
"totalBytes": 2483120
},
"initials": "JD",
"isEdited": false
},
"receiver": {
"fullName": "Jane Doe",
"firstName": "Jane",
"phoneNational": [
"(555) 555-0100"
],
"avatar": {
"name": "IMG_0001.HEIC",
"convertedName": "IMG_0001_display.png",
"transferState": 5,
"totalBytes": 2483120
},
"initials": "JD",
"isEdited": false
},
"isEmpty": false,
"iMessageType": "na",
"isFromMe": true,
"isDelivered": true,
"isDeleted": false,
"isMissingMedia": false,
"isSystemMessage": false,
"attachment": {
"name": "IMG_0001.HEIC",
"convertedName": "IMG_0001_display.png",
"transferState": 5,
"totalBytes": 2483120
},
"additionalAttachments": [
{
"name": "IMG_0001.HEIC",
"convertedName": "IMG_0001_display.png",
"transferState": 5,
"totalBytes": 2483120
}
],
"date": "2026-01-15T14:30:00.000Z",
"sentAt": "2026-01-15T14:30:00.000Z",
"readAt": "2026-01-15T14:30:00.000Z",
"deletedAt": "2026-05-04T09:42:00Z",
"recoveredAt": "2026-05-04T09:42:00Z",
"parentMessageText": "Are we still on for dinner?",
"parentMessageAttachment": {
"name": "IMG_0001.HEIC",
"convertedName": "IMG_0001_display.png",
"transferState": 5,
"totalBytes": 2483120
},
"parentMessageIndex": 41,
"service": "iMessage",
"mimeType": "image/jpeg",
"editHistory": [
{
"date": "2026-01-15T14:30:00.000Z",
"text": "See you at 7"
}
],
"deletedMessagesLogs": {
"total": 2,
"minDate": "2026-01-15T14:05:00.000Z",
"maxDate": "2026-01-15T14:20:00.000Z",
"deletedMessages": []
},
"messageIndex": 42,
"attachedTags": [
{
"tagId": "507f1f77bcf86cd799439011",
"tag": "Important",
"addedBy": "user",
"addedById": "507f1f77bcf86cd799439012",
"removedAt": "2026-05-04T09:42:00Z",
"removedBy": "user",
"removedById": "string"
}
],
"ocSharedStatus": "shared",
"collectionCount": 1,
"durationInSeconds": 32,
"callDurationInSeconds": 125,
"callType": "incoming",
"callSource": "phone",
"conversationId": "65a1b2c3d4e5f6a7b8c9d0e2"
}
]
}
]
},
"statusCode": 200,
"timestamp": "2026-01-15T10:15:00.000Z"
}