Skip to main content
GET
/
api
/
agents
/
{agentId}
/
chats
List chats for an agent
curl --request GET \
  --url https://api.getstrada.com/api/agents/{agentId}/chats \
  --header 'Authorization: Bearer <token>'
{
  "chats": [
    {
      "chatId": "chat_123abc",
      "agentId": "agent_456def",
      "customerUniqueId": "customer_789ghi",
      "createdAt": "2024-01-15T10:30:00Z",
      "status": "active",
      "summary": "Customer inquired about order status and received tracking information",
      "transcript": {
        "messages": [
          {
            "role": "user",
            "content": "Hello, I need help with my order",
            "createdAt": "2024-01-15T10:30:00Z"
          },
          {
            "role": "bot",
            "content": "I'd be happy to help you with your order. Could you please provide your order number?",
            "createdAt": "2024-01-15T10:30:05Z"
          },
          {
            "role": "user",
            "content": "It's ORD-12345",
            "createdAt": "2024-01-15T10:30:20Z"
          },
          {
            "role": "tool",
            "toolCallId": "call_123abc",
            "toolName": "getOrderStatus",
            "toolArguments": "{\"orderId\":\"ORD-12345\"}",
            "toolResult": "{\"status\":\"shipped\",\"trackingNumber\":\"TRK-789\"}",
            "createdAt": "2024-01-15T10:30:25Z"
          },
          {
            "role": "bot",
            "content": "Your order has been shipped! The tracking number is TRK-789.",
            "createdAt": "2024-01-15T10:30:30Z"
          },
          {
            "role": "agent",
            "content": "I can help you further with that",
            "agentName": "John Smith",
            "createdAt": "2024-01-15T10:35:10Z"
          }
        ]
      },
      "chatVariables": {
        "customerId": "12345",
        "source": "website"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.getstrada.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API Key authentication

Path Parameters

agentId
string
required

ID of the agent to list chats for

Query Parameters

createdAtGt
string<date-time>
createdAtLt
string<date-time>
exclude
enum<string>[]
Available options:
summary

Response

Successfully retrieved chats

chats
object[]