---
title: "List a widget's conversations"
description: "List the conversations anonymous visitors had through a widget, latest first, with their messages, thumbs and cost. The logs, filtered on the widget."
canonical: "https://lookio.app/docs/api/widgets/list-widget-conversations"
updated: "2026-10-17"
---

# List a widget's conversations

Requires `assistants:write`.

This is [List the workspace's conversation logs](/docs/api/logs/list-log-conversations) filtered on one widget, so the entries have the same shape: `channel` is `widget`, and `end_user` is the visitor's random id, the same for every conversation from the same browser. Visitors are anonymous. Results come latest first, and you page with `cursor`: see [Pagination](/docs/api/conventions#pagination).

Conversations are kept 90 days after their last message. Questions asked in the app's preview are not listed. Use the thumbs down to find where the assistant fails. See [Visitors' conversations](/docs/widget/conversations).

```http
GET https://api.lookio.app/v1/widgets/{widget_id}/conversations
```

## Authorizations

- `Authorization` (bearer, in header, required)

## Path parameters

- `widget_id` (`string`, required, pattern: `^wdg_[abcdefghjkmnpqrstuvwxyz23456789]{12}$`)

## Query parameters

- `limit` (`integer`, range: `1–100`): Number of items to return. Values outside 1-100 are clamped, and the response reports the limit actually applied.
- `cursor` (`string`, length: `1–40 chars`): Pass `next_cursor` from the previous page, unchanged.

## Response

**200**: List a widget's conversations

- `data` (`object[]`, required)
- `data.id` (`string`, required, pattern: `^cnv_[abcdefghjkmnpqrstuvwxyz23456789]{12}$`)
- `data.channel` (`enum<string>`, required, one of: `widget, api, mcp`): `widget`: a visitor on your website. `api`: an API key through REST, the CLI or the SDK. `mcp`: an API key through the MCP server.
- `data.title` (`string`, required): The first question.
- `data.assistant` (`object`, required)
- `data.assistant.id` (`string`, required)
- `data.assistant.name` (`string,null`, required): Null when the assistant was deleted.
- `data.widget` (`object | null`, required): The widget, for the `widget` channel.
- `data.widget.id` (`string`, required)
- `data.widget.name` (`string`, required)
- `data.api_key` (`object | null`, required): The API key, for the `api` and `mcp` channels.
- `data.api_key.id` (`string`, required)
- `data.api_key.name` (`string,null`, required): Null once the key is deleted.
- `data.end_user` (`string,null`, required): Who was asking: a widget visitor's random id, or the `end_user` the product sent. Null when an API key sent none.
- `data.message_count` (`integer`, required): Questions and answers together.
- `data.credits` (`integer`, required): What this conversation's answers cost.
- `data.thumbs_up` (`integer`, required)
- `data.thumbs_down` (`integer`, required)
- `data.created_at` (`string`, required)
- `data.updated_at` (`string`, required): The last activity. Conversations are listed by it, latest first.
- `data.locked` (`boolean`, required): Older than the plan keeps conversations readable (7 days on Free, 90 on Starter, 1 year on Pro, from the last activity). Its text is hidden, not yet deleted: `title` is then a date and `messages` is empty, and a higher plan shows it again.
- `has_more` (`boolean`, required): True when another page follows: pass `next_cursor` back as `cursor`.
- `next_cursor` (`string,null`, required): Pass it back unchanged as `cursor`. Null on the last page.
- `limit` (`integer`, required): The page size actually applied.
- `request_id` (`string`, required)

```json
{
  "data": [
    {
      "id": "<string>",
      "channel": "widget",
      "title": "<string>",
      "assistant": {
        "id": "<string>",
        "name": null
      },
      "widget": {
        "id": "<string>",
        "name": "<string>"
      },
      "api_key": {
        "id": "<string>",
        "name": null
      },
      "end_user": null,
      "message_count": 123,
      "credits": 123,
      "thumbs_up": 123,
      "thumbs_down": 123,
      "created_at": "<string>",
      "updated_at": "<string>",
      "locked": true
    }
  ],
  "has_more": true,
  "next_cursor": null,
  "limit": 123,
  "request_id": "<string>"
}
```

**400**: Possible codes: invalid_request, unknown_field, invalid_parameter, invalid_cursor

- `error` (`object`, required)
- `error.type` (`string`, required)
- `error.code` (`string`, required)
- `error.message` (`string`, required)
- `error.param` (`string`)
- `error.docs_url` (`string`, required)
- `error.action_url` (`string<uri>`)
- `request_id` (`string`, required)

```json
{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}
```

**401**: Possible codes: authentication_required, invalid_api_key, api_key_expired, api_key_revoked, invalid_access_key

- `error` (`object`, required)
- `error.type` (`string`, required)
- `error.code` (`string`, required)
- `error.message` (`string`, required)
- `error.param` (`string`)
- `error.docs_url` (`string`, required)
- `error.action_url` (`string<uri>`)
- `request_id` (`string`, required)

```json
{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}
```

**403**: Possible codes: insufficient_scope, feature_not_available, admin_required, permission_denied

- `error` (`object`, required)
- `error.type` (`string`, required)
- `error.code` (`string`, required)
- `error.message` (`string`, required)
- `error.param` (`string`)
- `error.docs_url` (`string`, required)
- `error.action_url` (`string<uri>`)
- `request_id` (`string`, required)

```json
{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}
```

**404**: Possible codes: resource_not_found

- `error` (`object`, required)
- `error.type` (`string`, required)
- `error.code` (`string`, required)
- `error.message` (`string`, required)
- `error.param` (`string`)
- `error.docs_url` (`string`, required)
- `error.action_url` (`string<uri>`)
- `request_id` (`string`, required)

```json
{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}
```

**429**: Possible codes: rate_limited

- `error` (`object`, required)
- `error.type` (`string`, required)
- `error.code` (`string`, required)
- `error.message` (`string`, required)
- `error.param` (`string`)
- `error.docs_url` (`string`, required)
- `error.action_url` (`string<uri>`)
- `request_id` (`string`, required)

```json
{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}
```

**500**: Possible codes: internal_error

- `error` (`object`, required)
- `error.type` (`string`, required)
- `error.code` (`string`, required)
- `error.message` (`string`, required)
- `error.param` (`string`)
- `error.docs_url` (`string`, required)
- `error.action_url` (`string<uri>`)
- `request_id` (`string`, required)

```json
{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>"
  },
  "request_id": "<string>"
}
```

**Example request**

```bash
curl --request GET \
  --url 'https://api.lookio.app/v1/widgets/<widget_id>/conversations' \
  --header 'Authorization: <api-key>'
```