Skip to main content
GET
Get Org Inbox Chats

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

The ID of the org

Query Parameters

Search term to filter chats

Maximum string length: 256
assistant_id
string
Maximum string length: 128
assistant_integration_id
string
Maximum string length: 128
integration_id
enum<string>

ID of the connection integration

Available options:
internal,
org,
custom,
whatsapp_bot,
messenger_bot,
instagram_dm,
tiktok_dm,
telegram_bot,
gmail,
slack_bot,
twilio,
telnyx,
email
conversation_id
string
Maximum string length: 128
contact_id
string
Maximum string length: 128
segment_id
string
Maximum string length: 128
assigned_user_id
string
Maximum string length: 128
status
enum<string>
Available options:
ALL,
RUNNING,
COMPLETED,
FAILED,
CANCELED
state
enum<string>
Available options:
ALL,
OPEN,
SNOOZED,
CLOSED
ai_status
enum<string>
Available options:
ALL,
ENABLED,
DISABLED
filter
enum<string>

Filter for chats

Available options:
ALL,
UNREAD,
UNRESOLVED,
RESOLVED,
ASSIGNED_TO_ME,
UNASSIGNED
referral_type
enum<string>
Available options:
ALL,
messenger_ad,
messenger_product,
messenger_product_template,
whatsapp_ad,
whatsapp_product,
whatsapp_order,
instagram_ad,
instagram_product,
instagram_product_template,
instagram_post,
instagram_reel,
instagram_story,
instagram_story_mention,
messenger_post,
messenger_reel,
tiktok_ad,
tiktok_post_share,
tiktok_short_link,
web_widget
csat_max
enum<string>

Filter chats with CSAT score less than or equal to this value. 0 means no filter.

Available options:
0,
1,
2,
3,
4,
5
page
number

Page number

take
number

Number of items to take

next
string

Next page token (Only used on special endpoints)

Response

200 - application/json
id
string
required
title
string | null
required

The title of the chat

model
string
required

The model used for the chat

members
object[]
required

The members of the chat

temporary
boolean
required

Whether the chat is temporary and would be deleted after 24 hours of last activity

visibility
enum<string>
required

The visibility of the chat

Available options:
PRIVATE,
PUBLIC_READ,
PUBLIC_WRITE
pinned
boolean
required

Whether the chat is pinned in the user interface

status
enum<string>
required

The status of the chat

Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELED
shared_url
string | null
required

The shared URL of the chat, if it is shared

created_at
string<date-time> | null
required
updated_at
string<date-time> | null
required
tools
object[]

The tools available in the chat

skills
object[]

The skills enabled in the chat

features
object

Per-chat features and run settings: model features plus approval mode, auto-discover, and org-chat tool toggles.

org_id
string
state
object

Schema for the chat state

The link to the chat in the integration

last_message
object

The chat message schema

referral
object

Referral/commerce event data from Meta platforms — ads, products, orders.