List Conversations

GET

user

conversations

curl -X GET "https://app.receptonic.com/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://app.receptonic.com/api/user/conversations?type=widget&per_page=10',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.data); // Array of conversations

import requests

response = requests.get(
    'https://app.receptonic.com/api/user/conversations',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
        'type': 'widget',
        'per_page': 10
    }
)

data = response.json()
print(data['data'])

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://app.receptonic.com/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://app.receptonic.com/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "active": false
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.receptonic.com/api/user/conversations?page=2",
  "path": "https://app.receptonic.com/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}

This endpoint returns a paginated list of conversations belonging to the authenticated user’s assistants. Use this to display conversation history, filter by type, or integrate with your CRM.

This endpoint requires authentication. Pass your API key in the Authorization header as a Bearer token.

Query Parameters

string

Filter conversations by type. Possible values: test, widget, whatsapp, api

integer

Filter conversations by assistant ID (must belong to the authenticated user)

string

Filter conversations from this date (YYYY-MM-DD format)

string

Filter conversations until this date (YYYY-MM-DD format)

integer

Number of conversations per page (1-100, default: 15)

integer

Page number (default: 1)

Response Fields

array

Show properties

string

The unique UUID identifier of the conversation

string

The UUID of the assistant handling this conversation

string

The name of the assistant handling this conversation

string

The conversation type: test, widget, whatsapp, or api

integer

Total number of messages in the conversation

number

The total cost of the conversation in USD

boolean

Whether AI responses are enabled for this conversation

string

The date and time when the conversation was created

string

The date and time when the conversation was last updated

integer

The current page number

integer

Number of items per page

integer

Total number of conversations matching the criteria

integer

The last page number

curl -X GET "https://app.receptonic.com/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://app.receptonic.com/api/user/conversations?type=widget&per_page=10',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.data); // Array of conversations

import requests

response = requests.get(
    'https://app.receptonic.com/api/user/conversations',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
        'type': 'widget',
        'per_page': 10
    }
)

data = response.json()
print(data['data'])

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://app.receptonic.com/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://app.receptonic.com/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "active": false
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.receptonic.com/api/user/conversations?page=2",
  "path": "https://app.receptonic.com/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}

Conversation Types

Type	Description
`test`	Internal test conversations from the assistant testing interface
`widget`	Conversations from the web chat widget
`whatsapp`	WhatsApp Business conversations
`api`	Conversations created via the API

Use Cases

Analytics Dashboard: Display conversation metrics and trends
CRM Integration: Sync conversation data with your customer database
Quality Monitoring: Review conversation volumes by type and assistant
Billing Review: Track conversation costs across your organization

⌘I

curl -X GET "https://app.receptonic.com/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://app.receptonic.com/api/user/conversations?type=widget&per_page=10',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data.data); // Array of conversations

import requests

response = requests.get(
    'https://app.receptonic.com/api/user/conversations',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
        'type': 'widget',
        'per_page': 10
    }
)

data = response.json()
print(data['data'])

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://app.receptonic.com/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://app.receptonic.com/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "active": false
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.receptonic.com/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.receptonic.com/api/user/conversations?page=2",
  "path": "https://app.receptonic.com/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}

API Reference

Assistants

Folders

Labels

Calls

Conversations

AI

Mid Call Tools

Leads

Campaigns

Automations

Phone Numbers

SIP Trunks

Knowledgebases

SMS

WhatsApp

Webhooks

API Keys

Query Parameters

Response Fields

Conversation Types

Use Cases