> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get conversation

> Retrieve full message history for an existing conversation

Fetch the complete message history of an existing Famulor conversation. Use this to resume a chat, display past messages, or analyze interactions.

### Path Parameters

<ParamField path="uuid" type="string" required>
  UUID of the conversation to retrieve
</ParamField>

### Error Responses

<ResponseField name="status" type="boolean">
  Will be `false` when an error occurs
</ResponseField>

<ResponseField name="error" type="string">
  Error message. Possible values:

  * `Conversation not found` - The provided UUID does not match any conversation
</ResponseField>

<RequestExample>
  ```bash cURL theme={null} theme={null}
  curl -X GET "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  ```

  ```javascript JavaScript theme={null} theme={null}
  const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';

  const response = await fetch(
    `https://app.famulor.de/api/conversations/${conversationId}`
  );

  const data = await response.json();
  console.log(data.history);
  ```

  ```python Python theme={null} theme={null}
  import requests

  conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'

  response = requests.get(
      f'https://app.famulor.de/api/conversations/{conversation_id}'
  )

  data = response.json()
  print(data['history'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null} theme={null}
  {
    "status": true,
    "history": [
      {
        "role": "assistant",
        "content": "Hello! Welcome to our support. How can I help you today?"
      },
      {
        "role": "user",
        "content": "I'd like to schedule a demo"
      },
      {
        "role": "assistant",
        "content": "I'd be happy to help you schedule a demo! I have availability tomorrow at 2 PM or Thursday at 10 AM. Which works better for you?",
        "function_calls": [
          {
            "name": "check_calendar_availability",
            "arguments": {
              "date_range": "next_7_days"
            },
            "result": {
              "available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
            }
          }
        ]
      },
      {
        "role": "user",
        "content": "Thursday at 10 AM works for me"
      },
      {
        "role": "assistant",
        "content": "I've scheduled your demo for Thursday, January 12th at 10 AM. You'll receive a calendar invitation shortly. Is there anything specific you'd like us to cover during the demo?",
        "function_calls": [
          {
            "name": "book_appointment",
            "arguments": {
              "datetime": "2025-01-12T10:00:00",
              "title": "Product Demo"
            },
            "result": {
              "success": true,
              "booking_id": "abc123"
            }
          }
        ]
      }
    ],
    "variables": {
      "user_name": "Jane Smith",
      "plan": "premium"
    }
  }
  ```

  ```json 200 API Conversation with External ID theme={null} theme={null}
  {
    "status": true,
    "history": [
      {
        "role": "assistant",
        "content": "Hi! I'm following up on your recent inquiry. How can I help you today?"
      },
      {
        "role": "user",
        "content": "I wanted to know more about your enterprise plan"
      }
    ],
    "variables": {
      "lead_id": "12345",
      "source": "website"
    },
    "external_identifier": "crm-lead-12345"
  }
  ```

  ```json 200 WhatsApp Conversation theme={null} theme={null}
  {
    "status": true,
    "history": [
      {
        "role": "user",
        "content": "Hi, I need help with my order"
      },
      {
        "role": "assistant",
        "content": "Hello! I'd be happy to help you with your order. Could you please provide your order number?"
      }
    ],
    "variables": null,
    "whatsapp_sender": {
      "name": "Acme Corp Support",
      "phone": "+14155551234"
    },
    "customer": {
      "name": "John Doe",
      "phone": "+14155559876"
    }
  }
  ```

  ```json 404 Not Found theme={null} theme={null}
  {
    "status": false,
    "error": "Conversation not found"
  }
  ```
</ResponseExample>