Enterprise Feature - SMS is only available on Enterprise plans. Contact your Bland representative for access.
Headers
Your API key for authentication.
Query Parameters
The page number to retrieve. Defaults to
1
.The number of conversations per page. Defaults to
25
.Field to sort by. Allowed values:
created_at
, updated_at
, user_number
, agent_number
, is_active
, message_count
, curr_pathway_id
, curr_pathway_version
, timed_out_at
. Defaults to created_at
.Direction of sorting. Either
asc
or desc
. Defaults to desc
.A JSON-encoded array of filter objects. Each object should contain:
field
: one ofcreated_at
,updated_at
,user_number
,agent_number
,is_active
,message_count
,variables
,current_node_id
,curr_pathway_id
,curr_pathway_version
,timed_out_at
operator
: one ofeq
,contains
,startsWith
,endsWith
,gt
,gte
,lt
,lte
value
: the filter value
Response
A list of conversations matching the query.
Unique ID of the conversation.
ISO timestamp when the conversation was created.
ISO timestamp when the conversation was last updated.
The user-facing phone number in the conversation.
The assistant’s phone number in the conversation.
Arbitrary variables associated with the conversation.
ID of the current node in the conversational pathway.
The UUID of the current pathway being used in this conversation.
The specific version of the pathway being used.
ISO timestamp when the conversation timed out due to inactivity, if applicable.
Indicates whether the conversation is still active.
Number of messages in the conversation.
The content of the most recent message, if available.
The timestamp of the most recent message.
Optional ID of the conversational pathway, if configured.
Optional pathway metadata if available.
null
on success, or a list of errors on failure.Total number of conversations matching the query.
Total number of pages available.
The current page of the response.
Number of items per page in the current response.