Skip to main content
GET
https://app.famulor.de/api/
/
conversations
/
{uuid}
{
  "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"
          }
        }
      ]
    }
  ]
}
Fetch the complete message history of an existing Famulor conversation. Use this to resume a chat, display past messages, or analyze interactions.

​
Path Parameters

​
uuid
string
required
UUID of the conversation to retrieve

​
Request Example

cURL
curl -X GET "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch(
  "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7",
  {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  }
);

const data = await response.json();
Python
import requests

conversation_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7"
response = requests.get(
    f"https://app.famulor.de/api/conversations/{conversation_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)

print(response.json())

​
Response Fields

​
status
boolean
required
Indicates whether the request succeeded
​
history
array
required
Chronological list of messages (oldest first)

​
Response Examples

{
  "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"
          }
        }
      ]
    }
  ]
}

​
Use Cases

  • Resume conversations: restore history when users return
  • Analytics: review dialogues for QA or training
  • Integration: sync transcripts to CRM or support tools

​
Notes

  • History is ordered oldest to newest.
  • Function calls appear only when the assistant invoked tools during a message.
  • Pair with Create Conversation and Send Message for the full flow.