List conversations.

GET/api/v1/conversations

Browse API endpoints

Conversations / CRM REST API

Scope: conversations:read

Query parameters:

status - open, closed, snoozed
channel - Filter by channel type
contactId - Filter by contact ID to find all conversations for a specific contact
assignedTo - Filter by team member ID
limit - Max results (default 50, max 100)

Response: Array of conversations with embedded contact summary.

Loading endpoint details...

Build a request

Request example

Documented defaults and example values are ready. Change only the parameters you need.

Your CRM deployment URL

Replace the Bearer API key placeholder in the copied server-side code. No API key is entered or sent here.

Sub-account ID Agency keys onlyAgency-scoped keys require the X-Sub-Account-Id header.

status - open, closed, snoozed

channel - Filter by channel type

contactId - Filter by contact ID to find all conversations for a specific contact

assignedTo - Filter by team member ID

limit - Max results (default 50, max 100)

cURL

curl --request GET \
  --url 'https://your-crm.example.com/api/v1/conversations?limit=50' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

This shows a static response from the documentation. It does not send a request to your CRM or use an API key.