---
title: "Get Customer Conversations"
method: GET
path: "/customer-profiles/conversations"
tags: ["customer-profiles"]
---

# Get Customer Conversations

`GET /customer-profiles/conversations`

Return conversations linked to a customer by ServiceTitan id or known phones.

## Query parameters

- `st_customer_id` integer, required — ServiceTitan customer ID

## Response `200`

Successful Response

- CustomerConversationSummary[]
  - `id` string, required
  - `customer_phone` string, required
  - `customer_name` string, nullable
  - `conversation_status` string, nullable
  - `technician_name` string, nullable
  - `last_message_at` string, nullable
  - `last_message_body` string, nullable
  - `unread_count` integer
  - `is_archived` boolean
  - `summary` string, nullable
  - `message_count` integer
  - `created_at` string, nullable
  - `messages` CustomerConversationMessagePreview[]
    - `id` string, required
    - `direction` string, nullable
    - `body` string, nullable
    - `created_at` string, nullable
    - `sender_name` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/noso/crucible-backend-api/revisions/112efbdea3eb/schema)