Skip to main content
GET
List conversations

Authorizations

X-API-Key
string
header
required

API Key for authentication

Query Parameters

ownerId
string<uuid>
required

LinkedIn account owner whose inbox is being read. Often a managed account rather than the authenticated user — call user_list-shared first and pick the owner whose LinkedIn profile holds the conversations.

view
enum<string>
required

Required lowercase inbox view. for-review is the For Review tab. Suggested is not accepted.

Available options:
unread,
all,
needs-reply,
for-review,
auto,
snoozed,
ended
campaignId
string<uuid>

Optional campaign filter. When omitted, the list covers all campaigns of the owner that the caller can access — never conversations outside those campaigns.

prospectListId
string<uuid>

Optional Prospect List filter.

Case-insensitive LinkedIn display-name search, not message text. SQL LIKE wildcards % and _ remain active. Omit for no search; null and blank text are invalid.

Minimum string length: 1
limit
integer
default:20

Number of records requested for this page.

Required range: 1 <= x <= 50
offset
integer
default:0

Offset from the start of the filtered result set.

Required range: 0 <= x <= 2147483647

Response

status
string
required

Response status

Allowed value: "success"
data
object
required
message
string
required

Success message

Example:

"Operation completed successfully"