Skip to main content
POST
Search all conversations
Required scope: CONVERSATIONS_READ
This endpoint is paginated. Use page and size in the request body to control results. See Pagination.

Search behavior

The search field is a keyword search, not a natural language query. Extract keywords from the user’s question before passing them. How matching works:
  • Terms are AND’d"billing refund" matches items containing both words
  • Prefix matching is used — "bill" matches “billing”, “billed”, etc.
  • Searches across: call transcripts, call summaries, and SMS message content
  • Use sort=RELEVANCE to rank results by match quality instead of date

Field notes

Extend parameter

Passing an unsupported value returns a 400 error with code UNSUPPORTED_EXTEND_VALUE.

Authorizations

Authorization
string
header
required

Body

application/json
allo_number
string
contact_number
string
user_id
string
direction
enum<string>
Available options:
INBOUND,
OUTBOUND
type
enum<string>
default:ALL
Available options:
CALL,
SMS,
ALL
result
enum<string>
Available options:
ANSWERED,
VOICEMAIL,
TRANSFERRED
tags
string[]
unread
boolean
unresponded
boolean

Keyword search (not natural language). Extract keywords from the user's question. Terms are AND'd with prefix matching — 'billing refund' matches items containing both words, 'bill' matches 'billing'. Searches across call transcripts, summaries, and SMS content.

sort
enum<string>
default:DATE_DESC
Available options:
DATE_DESC,
DATE_ASC,
RELEVANCE
extend
string
page
integer
default:1
size
integer
default:20
Required range: x <= 100
date
object

Date range to filter by

Response

Search results

data
object[]
pagination
object