GET /v1/conversations/messages/search
GET
/v1/conversations/messages/search
const url = 'https://seu-endereco-da-api/v1/conversations/messages/search';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://seu-endereco-da-api/v1/conversations/messages/search \ --header 'Authorization: Bearer <token>'Permissão que a Chave de acesso precisa: Ler conversas (conversations:read).
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Query Parameters
Seção intitulada “Query Parameters”q
string
cursor
string
limit
string
Responses
Seção intitulada “Responses”Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
conversationId
required
string
contactName
required
string
text
required
string
type
required
string
transcription
required
What the audio says; this is what the search matched on an audio message
string
createdAt
required
string format: date-time
channelId
required
string
channelName
required
string
channelProvider
required
string
channelCoexistence
required
The channel runs in coexistence with the WhatsApp Business app
boolean
sessionId
required
The service session the message fell into
string
sessionOpenedAt
required
string format: date-time
nextCursor
required
string
Example generated
{ "items": [ { "id": "example", "conversationId": "example", "contactName": "example", "text": "example", "type": "example", "transcription": "example", "createdAt": "2026-04-15T12:00:00Z", "channelId": "example", "channelName": "example", "channelProvider": "example", "channelCoexistence": true, "sessionId": "example", "sessionOpenedAt": "2026-04-15T12:00:00Z" } ], "nextCursor": "example"}