---
title: "List Conversations"
method: GET
path: "/user/conversations"
tags: ["Conversations"]
---

# List Conversations

`GET /user/conversations`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/conversations`
- Auth: HTTP bearer

List all conversations of the authenticated user with filtering and cursor pagination

[Docs](https://docs.famulor.io/api-v1/conversations/list)

## Query parameters

- `type` 'test' | 'widget' | 'whatsapp' | 'api'
- `assistant_id` integer
- `customer_phone` string
- `whatsapp_sender_phone` string
- `external_identifier` string
- `per_page` integer
- `cursor` string

## Response `200`

response

- object
  - `data` object[]
    - `id` string: The unique UUID of the conversation
    - `assistant_id` string: The UUID of the assistant handling this conversation
    - `assistant_name` string: The name of the assistant handling this conversation
    - `type` string: The conversation type: `test`, `widget`, `whatsapp`, or `api`
    - `variables` object, nullable: Custom variables associated with the conversation (key-value pairs)
    - `external_identifier` string: The identifier from your external system for this conversation. Only present for conversations of type `api` if an external identifier was set.
    - `message_count` integer: Total number of messages in the conversation
    - `total_cost` number: The total cost of the conversation in USD
    - `ai_enabled` boolean: Indicates if AI responses are enabled for this conversation
    - `created_at` string: Date and time when the conversation was created
    - `updated_at` string: Date and time when the conversation was last updated
    - `whatsapp_sender` object: Information about the WhatsApp Business sender. Only present for conversations of type `whatsapp`.
      - `name` string: Display name of the WhatsApp sender (company name)
      - `phone` string: Phone number of the WhatsApp sender
    - `customer` object: Customer information. Only present for conversations of type `whatsapp`.
      - `name` string: Name of the customer (if available)
      - `phone` string: Phone number of the customer
  - `next_cursor` string: Cursor to fetch the next page of results. Pass this as the `cursor` parameter in your next request. `null` if there are no further results.
  - `prev_cursor` string, nullable: Cursor to fetch the previous page of results. `null` if this is the first page.
  - `per_page` integer: Number of items per page

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)