Skip to main content
GET
/
conversations
/
{uuid}
curl -X GET "https://app.autocalls.ai/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"

{
  "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"
  }
}
This endpoint retrieves the complete message history of an existing conversation. Use this to display previous messages when resuming a conversation or to review conversation content.

​
Path Parameters

​
uuid
string
required
The unique UUID identifier of the conversation to retrieve

​
Response Fields

​
status
boolean
Indicates whether the request was successful
​
history
array
Array of messages in the conversation, ordered chronologically (oldest first).
​
variables
object
Custom variables associated with the conversation (key-value pairs). Returns null if no variables are set.
​
external_identifier
string
Your external system’s identifier for this conversation. Only present for api type conversations that have an external identifier set.
​
whatsapp_sender
object
The WhatsApp business sender information. Only present for whatsapp type conversations.
​
customer
object
The customer information. Only present for whatsapp type conversations.

​
Error Responses

​
status
boolean
Will be false when an error occurs
​
error
string
Error message. Possible values:
  • Conversation not found - The provided UUID does not match any conversation
curl -X GET "https://app.autocalls.ai/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"

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

​
Variables

All conversations include a variables field containing custom key-value pairs set when the conversation was created. Use variables to:
  • Store user context (name, plan, preferences)
  • Track lead information from your forms
  • Pass custom data for personalized AI responses

​
API Conversations

For API-created conversations, the response may include an external_identifier field if one was set when creating the conversation. This allows you to:
  • Link conversations to your CRM leads or contacts
  • Track conversations across your internal systems
  • Look up conversations by your external reference

​
WhatsApp Conversations

For WhatsApp conversations, the response includes additional fields:
  • whatsapp_sender: The business WhatsApp number that handled the conversation (name and phone)
  • customer: The customer who initiated or received the conversation (name and phone)
These fields help you identify the parties involved when integrating WhatsApp conversations with your CRM or support systems.

​
Use Cases

  • Resume conversations: Retrieve history when a user returns to continue a conversation
  • Analytics: Review conversation content for quality assurance
  • CRM Integration: Use external_identifier and variables to sync with your CRM
  • WhatsApp tracking: Match conversations to customers using their phone numbers