HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

List Conversations

🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-04-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Returns Customer Agent conversations for the calling company.

Results are ordered with newest conversations first. Supports
filters by status and created_at time window, plus
cursor pagination for large pulls. Use to audit production
behavior, spot-check escalations, or feed conversation samples
back into Configure decisions.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
agents:read

Query Params
fields[customer-agent-conversation]
array of strings
fields[customer-agent-conversation]
string

For more information please visit https://developers.klaviyo.com/en/v2026-04-15.pre/reference/api-overview#filtering
Allowed field(s)/operator(s):
created_at: greater-or-equal
status: any, equals

string

Page cursor

integer
1 to 100
Defaults to 50

Default: 50. Min: 1. Max: 100.

Headers
string
required
Defaults to 2026-04-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json