conversations

List Conversations

Get list of organization conversations.

For org:admin users (managers/web dashboard): Returns ALL organization conversations For non-admin users (technicians/mobile app): Returns only their own conversations

Returns conversations sorted by most recent activity first. Excludes archived conversations by default.

get/conversations/list

Query parameters

include_archivedboolean

Response

Successful Response

idstring uuid required
contact_idstring nullable
customer_phonestring required
customer_namestring nullable
customer_idstring nullable
followup_idstring uuid nullable
conversation_statusstring nullable
last_message_atstring date-time nullable
last_message_bodystring nullable
last_message_directionstring nullable
unread_countinteger required
is_archivedboolean required
created_atstring date-time required
summarystring nullable
summary_generated_atstring date-time nullable
call_to_actionstring nullable
agent_contextstring nullable
prioritystring nullable
intent_updated_atstring date-time nullable
technician_namestring nullable
technician_first_namestring nullable
technician_last_namestring nullable
job_idstring nullable
followup_statusstring nullable
followup_kindstring nullable
min_estimate_valuenumber nullable
max_estimate_valuenumber nullable
addressstring nullable
won_amountnumber nullable
lost_reasonstring nullable
tradestring nullable
job_typestring nullable
sold_estimateobject nullable
intent_prioritystring nullable
triggered_by_toolstring nullable
source_systemstring nullable
hcp_customer_idstring nullable
sourcestring nullable
aspire_engagedboolean nullable
aspire_attempt_countinteger nullable
aspire_next_touch_atstring nullable
aspire_next_review_atstring nullable
aspire_last_reviewed_atstring nullable
aspire_review_reasonstring nullable
aspire_review_decisionstring nullable
aspire_detailsobject nullable

Changes

No recorded changes to this endpoint across all 2 revisions of this API.