Messages

Get all messages in a thread

Retrieve all messages in a conversation thread. Given any message ID in the thread, returns the originator message and all replies in chronological order.

If the message is not part of a thread, returns just that single message.

Supports pagination and configurable ordering.

get/v3/messages/{messageId}/thread

Request

  • Base URL: https://api.linqapp.com/api/partner
  • URL: https://api.linqapp.com/api/partner/v3/messages/{messageId}/thread
  • Auth: HTTP bearer

Path parameters

messageIdstring uuid required
Example:69a37c7d-af4f-4b5e-af42-e28e98ce873a

ID of any message in the thread (can be originator or any reply)

Query parameters

cursorstring

Pagination cursor from previous next_cursor response

limitinteger

Maximum number of messages to return

order'asc' | 'desc'

Sort order for messages (asc = oldest first, desc = newest first)

Response

Thread retrieved successfully

next_cursorstring nullable

Cursor for fetching the next page of results (null if no more results)

Example response

{
  "messages": [
    {
      "id": "69a37c7d-af4f-4b5e-af42-e28e98ce873a",
      "chat_id": "94c6bf33-31d9-40e3-a0e9-f94250ecedb9",
      "service": "iMessage",
      "preferred_service": "iMessage",
      "from": "+12052535597",
      "from_handle": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "handle": "+15551234567",
        "service": "iMessage",
        "joined_at": "2025-05-21T15:30:00.000-05:00",
        "line_type": "iMessage"
      },
      "parts": [
        {
          "type": "text",
          "value": "Hello!"
        }
      ],
      "reply_to": {
        "message_id": "550e8400-e29b-41d4-a716-446655440000"
      },
      "is_from_me": true,
      "is_delivered": true,
      "delivery_status": "pending",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "sent_at": "2024-01-15T10:30:05Z",
      "delivered_at": "2024-01-15T10:30:10Z",
      "read_at": "2024-01-15T10:35:00Z",
      "reconciled_at": "2024-01-15T14:05:00Z",
      "effect": {
        "type": "screen",
        "name": "confetti"
      }
    }
  ],
  "next_cursor": "eyJpZCI6IjEyMzQ1Njc4OTAiLCJ0cyI6MTYzMDUwMDAwMH0="
}

Changes

No recorded changes to this operation across all 1 revision of this API.