Fetchply Docs
API reference
GET
/api/v1/agents/{id}/conversations

List conversations for an agent, newest first, paged with limit/offset and filterable by channel or state. Includes visitor contact details the agent captured, never network or location data. Requires the read:conversations permission.

Authorization

BearerAuth read:conversations
AuthorizationBearer <token>

In: header

Scope: read:conversations

Path Parameters

id*string

Query Parameters

limit?integer
offset?integer
channel?string
state?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/agents/string/conversations"
{
  "items": [
    {
      "id": "sess_9f8e7d",
      "agentId": "a1b2c3d4e5",
      "channel": "widget",
      "firstMessage": "Where is my order?",
      "messageCount": 6,
      "visitorName": "Ada Lovelace",
      "visitorEmail": "[email protected]",
      "visitorPhone": null,
      "tags": [
        "vip"
      ],
      "handoffStatus": "ai",
      "rating": 4,
      "startedAt": "2026-08-01T10:00:00.000Z",
      "lastMessageAt": "2026-08-01T10:05:00.000Z",
      "endedAt": null
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

List unanswered questions GET

Questions the agent could not answer in the period: the most actionable training signal. Returns 403 with the required plan on plans without advanced analytics. Requires the `read:analytics` permission.

Get a conversation GET

One conversation with its transcript (capped at 500 messages; `truncated` is true when longer). Returns 404 when the conversation does not exist or belongs to an agent this key cannot access. Requires the `read:conversations` permission.