---
title: "Listar conversaciones"
method: GET
path: "/v1/conversations"
tags: ["Conversations"]
---

# Listar conversaciones

`GET /v1/conversations`

Conversaciones de la empresa autenticada, con filtros avanzados y paginación.

## Query parameters

- `status` 'opened' | 'closed' | 'inactive'
- `tags` string
- `fromDate` string, date-time
- `toDate` string, date-time
- `channel` string
- `phase` string
- `agent` string
- `preAssigned` string
- `condition` string
- `utmSource` string
- `utmMedium` string
- `utmCampaign` string
- `search` string
- `limit` integer
- `offset` integer
- `page` integer
- `sort` string

## Response `200`

Lista de conversaciones

- ConversationListResponse — Respuesta del listado de conversaciones. **Atención:** `data` NO es un arreglo, es un **objeto (mapa) indexado por el id de la conversación** — cada clave es el `id` y su valor es la conversación. Para recorrerlo usá los valores del objeto (ej. `Object.values(respuesta.data)`), no un índice numérico.
  - `pagination` Pagination — Metadatos de paginación que acompañan a las respuestas de listado. Usá `page`/`limit` o `offset`/`limit` para recorrer todas las páginas mientras `hasNext` sea `true`.
    - `page` integer — Número de página actual (1-based).
    - `limit` integer — Cantidad de resultados por página. Máximo: 100.
    - `total` integer — Total de resultados que matchean la consulta.
    - `totalPages` integer — Cantidad total de páginas.
    - `hasNext` boolean — Indica si hay una página siguiente.
    - `hasPrev` boolean — Indica si hay una página anterior.
  - `data` object — Mapa de conversaciones indexado por el id de cada conversación (la clave es el `conversationId` y el valor es el objeto `Conversation`).

---

[API](https://skmtc.net/cliengo/apis/cliengo-public-api.md) · [All operations](https://skmtc.net/cliengo/apis/cliengo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cliengo/cliengo-public-api/revisions/94c7ba7d6a11/schema)