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.

Outbound calls that reached a voicemail

When an outbound call is answered by the contact’s answering machine, result stays ANSWERED, because the carrier treats a machine pickup as an answer. Two fields carry the voicemail signal instead: Both are independent: detected_outbound_voicemail: true with voicemail_left: false means the call reached a voicemail and the caller hung up without leaving a message. Either can be null when that particular signal was never determined. null is not the same as false.
Filtering by result: "VOICEMAIL" returns inbound voicemails only. To find outbound calls that reached a voicemail, search with direction: "OUTBOUND" and filter the returned items on detected_outbound_voicemail. There is no request filter for it.

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

duration is the total call length in seconds, ringing included. recording_duration is the talk time, which is what the Allo app displays for recorded calls. For calls without a recording, the app falls back to duration. recording_download_url downloads the recording file with no Allo login, for 48 hours. It is returned only on lines of accounts created by a partner, never for a HIPAA call. See Recording links.

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