Conversations
List conversations
Returns conversation summaries, most recently active first, filterable by status, channel, contact, mailbox, and creation time (`after`, `before`).
GET
Returns conversation summaries, most recently active first, filterable by status, channel, contact, mailbox, and creation time (after, before). Pass nextCursor back as cursor for the next page; it is null on the last page. A conversation that gains activity while you page moves ahead of the cursor, so a walk lists each conversation at most once. Read a conversation's contacts, metadata, and resolution with GET /v1/conversations/{id}.
apiKeyheader
x-api-key<token>limit?|nullcursor?stringstatus?stringValue in
"active""waiting""resolved""escalated""archived"channel?stringValue in
"sms""whatsapp""email"contactId?stringMatch
^contact_[0-9a-hjkmnp-tv-z]{16,24}$mailboxId?stringMatch
^mbx_[0-9a-hjkmnp-tv-z]{16,24}$after?stringbefore?stringConversationPage
application/json- response
items*array<>nextCursor*string|nullimport { createClient } from "samva";const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });const result = await samva.conversations.list({});Example Response
{ "items": [ { "id": "string", "title": "string", "externalId": "string", "status": "active", "primaryChannel": "sms", "channels": [ "sms" ], "priority": 0, "urgency": "low", "tags": [ "string" ], "isTest": true, "messageCount": 0, "lastActivityAt": "string", "createdAt": "string" } ], "nextCursor": "string"}