Search Conversations & Messages

Updated about 2 hours ago•1 min read

GET

/v1/search

Executes an intelligent full-text search across conversations, message content, and customer identifiers with multi-attribute filtering.

Parameters

Name	Type	Description
`q`required	string	Search query term
`type`	string	Filter by resource: 'conversations' or 'messages'
`inbox_id`	string	Filter by inbox UUID
`status`	string	Filter by status: 'active', 'closed', 'snoozed', 'resolved'
`page`	integer	Page number
`per_page`	integer	Records per page (1-50, default: 20)

Responses

200Search results

{
  "data": {
    "conversations": [
      {
        "id": "cnv_777",
        "identifier": "CNV-1029",
        "title": "Payment Gateway Error"
      }
    ],
    "messages": [
      {
        "id": "msg_001",
        "content": "I have an error on payment checkout"
      }
    ]
  }
}