GET
List projected canonical messages

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

view_id
string<uuid>

Saved view filters are combined with request query params using AND semantics.

q
string

Indexed search over message text. Combined with saved-view text_search using AND.

Minimum string length: 3
search_mode
enum<string>
default:broad

Search behavior for q. broad matches any normalized word; exact matches the normalized phrase; exact_light matches ordered words within a small positional gap.

Available options:
broad,
exact,
exact_light
classification_status
enum<string>[]

Comma-separated classification statuses.

Available options:
pending,
completed,
skipped,
failed
intent
enum<string>[]

Comma-separated message intents.

Available options:
selling,
buying,
personal,
unknown
group_id
string<uuid>[]

Comma-separated group IDs.

listing_id
string<uuid>

Returns every canonical message whose projected watch listing has the exact same normalized listing fields and sender contact as this listing.

contact_id
string<uuid>[]

Comma-separated contact IDs.

country_prefix
string[]

Comma-separated E.164 country phone prefixes without a leading plus sign.

from_ms
integer<int64>
to_ms
integer<int64>
last_seen_from_ms
integer<int64>
last_seen_to_ms
integer<int64>
include_revoked
boolean
default:false
cursor
string
page_size
integer
default:50
Required range: 1 <= x <= 200

Response

Cursor page of canonical messages.

items
object[]
required
has_more
boolean
required
next_cursor
string | null