> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Conversations

> Lista conversaciones con paginación y filtros por asignación, estado, inbox, equipo o etiquetas.

Lista las conversaciones de la cuenta. Puedes filtrar por asignado a mí, sin asignar, estado (open/resolved/pending/snoozed), inbox, equipo, etiquetas o término de búsqueda en mensajes.

## Autenticación

<ParamField header="api_access_token" type="string" required>
  Token de usuario (**userApiKey**).
</ParamField>

## Parámetros de ruta

<ParamField path="account_id" type="integer" required>
  ID de la cuenta.
</ParamField>

## Parámetros de consulta

<ParamField query="assignee_type" type="string" default="all">
  Filtro por asignación: `me`, `unassigned`, `all`, `assigned`.
</ParamField>

<ParamField query="status" type="string" default="open">
  Estado: `all`, `open`, `resolved`, `pending`, `snoozed`.
</ParamField>

<ParamField query="q" type="string">
  Término de búsqueda en el contenido de los mensajes.
</ParamField>

<ParamField query="inbox_id" type="integer">
  Filtrar por ID de inbox.
</ParamField>

<ParamField query="team_id" type="integer">
  Filtrar por ID de equipo.
</ParamField>

<ParamField query="labels" type="array">
  Lista de etiquetas (strings).
</ParamField>

<ParamField query="page" type="integer" default="1">
  Número de página.
</ParamField>

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://app.yampi.ai/api/v1/accounts/1/conversations?status=open&assignee_type=unassigned&page=1' \
    -H 'api_access_token: TU_TOKEN' \
    -H 'Content-Type: application/json'
  ```
</RequestExample>

## Respuesta exitosa

Objeto con lista de conversaciones según el esquema `conversation_list` del OpenAPI (payload de conversaciones y metadatos de paginación).

## Errores

* **400**: Bad Request — parámetros inválidos.
* **401**: No autenticado.