Skip to main content
GET
This feature requires the Agent Pro plan or higher. Attempting to use semantic search on the free plan returns 403 plan_upgrade_required.

Query Parameters

string
required
Natural language search query. The search uses vector embeddings — you can describe what you are looking for semantically (e.g., “angry customers”, “appointment confirmations”, “shipping inquiries”) rather than matching exact keywords.
string
Restrict search to messages on a specific phone number. Format: pn_.... If omitted, searches across all phone numbers in your organization.
number
default:"20"
Maximum results to return. Maximum: 50.

Response

SmsMessage[]
Array of messages ranked by semantic relevance to your query. Results are sorted by similarity score, most relevant first. See List SMS Messages for the full message schema.
Messages are indexed for vector search asynchronously after they are sent or received. There may be a short delay (typically under 5 seconds) before newly received messages appear in search results.
Last modified on March 19, 2026