> ## Documentation Index > Fetch the complete documentation index at: https://developers.nuvia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Listar conversaciones > Devuelve una lista paginada de conversaciones con filtros opcionales (inbox, agente, equipo, usuarios, status, período de fechas, etc.). ## OpenAPI ````yaml /es/openapi.json get /v1/conversations openapi: 3.0.0 info: title: Nuvia API - Empresa description: Documentación de la API para empresas version: '1.0' contact: {} servers: - url: https://api.nuvia.ai security: [] tags: - name: messages x-group: Mensagens - name: contacts x-group: Contatos - name: campaigns x-group: Campanhas - name: tables x-group: Tabelas e Listas - name: agents x-group: Agentes - name: conversations x-group: Conversas - name: inboxes x-group: Caixas de Entrada - name: knowledge x-group: Base de Conhecimento - name: Webhooks x-group: Webhooks - name: campaign-enrollments x-group: Inscrições em Campanha - name: custom-fields x-group: Campos Customizados paths: /v1/conversations: get: tags: - conversations summary: Listar conversaciones description: >- Devuelve una lista paginada de conversaciones con filtros opcionales (inbox, agente, equipo, usuarios, status, período de fechas, etc.). operationId: ConversationController_findConversations parameters: - name: x-company-id in: header description: >- Identificador de la empresa objetivo. Obligatorio solo para API keys globales (type=global). Se ignora para API keys de empresa y usuarios humanos. required: false schema: type: string - name: inboxId required: false in: query description: Filtrar por ID del inbox schema: type: string - name: agentId required: false in: query description: Filtrar por ID del agente schema: type: string - name: teamId required: false in: query description: Filtrar por ID del equipo schema: type: string - name: channel required: false in: query description: >- Filtrar por tipo(s) de canal del inbox, separados por coma (ej.: WAP_AUTO_CLOSER,LINKEDIN) schema: type: string items: type: string - name: stalled required: false in: query description: >- Filtrar conversaciones detenidas (sin actividad del contacto hace más de 24 h) schema: type: string - name: transferred required: false in: query description: Filtrar conversaciones transferidas de IA a agente humano schema: type: string - name: hasFollowUp required: false in: query description: Filtrar conversaciones con follow-up programado schema: type: string - name: inCampaign required: false in: query description: Filtrar conversaciones originadas de una campaña schema: type: string - name: inService required: false in: query description: Filtrar conversaciones en atención (excluye follow-up y campaña) schema: type: string - name: userIds required: false in: query description: Filtrar por IDs de los usuarios schema: type: string items: type: string - name: search required: false in: query schema: type: string - name: whoAnswering required: false in: query description: Filtrar por quién está respondiendo (AGENT/HUMAN) schema: type: string - name: status required: false in: query description: Filtrar por estado (OPEN, RESOLVED) schema: type: string items: type: string - name: agentStep required: false in: query description: Filtrar por IDs de los pasos del flujo del agente schema: type: string items: type: string - name: engagement required: false in: query description: Filtrar por niveles de engagement schema: type: string items: type: string - name: requiresAttention required: false in: query description: Filtrar conversaciones que requieren atención schema: type: string - name: hasScheduledMeeting required: false in: query description: Filtrar conversaciones con reunión programada (no cancelada) schema: type: string - name: startDate required: false in: query description: Fecha inicial para filtrar conversaciones (createdAt >= startDate) schema: type: string - name: endDate required: false in: query description: Fecha final para filtrar conversaciones (createdAt <= endDate) schema: type: string - name: advancedFilters required: false in: query description: 'Filtros avanzados en formato JSON: [{ field, operator, value }]' schema: maxItems: 20 type: string items: type: object properties: field: type: string maxLength: 200 operator: type: string enum: - eq - neq - contains - not_contains - starts_with - ends_with - gt - lt - is_empty - is_not_empty - is_any_of - is_all_of - is_none_of value: default: '' type: string maxLength: 1000 values: maxItems: 500 type: array items: type: string maxLength: 200 required: - field - operator - name: page required: false in: query description: Número de página (empieza en 1) schema: maximum: 9007199254740991 exclusiveMinimum: true default: 1 type: string minimum: 0 - name: rowsPerPage required: false in: query description: Cantidad de elementos por página schema: maximum: 9007199254740991 exclusiveMinimum: true default: 10 type: string minimum: 0 responses: '200': description: Lista de conversaciones devuelta correctamente content: application/json: schema: $ref: '#/components/schemas/ConversationsListResponseDto' '401': description: Token inválido o expirado '403': description: Sin permiso para acceder a este recurso security: - JWT-auth: [] components: schemas: ConversationsListResponseDto: type: object properties: result: type: array items: {} description: Lista de conversaciones meta: description: Metadatos de la paginación required: - result - meta securitySchemes: JWT-auth: scheme: bearer bearerFormat: JWT type: http description: Token JWT de autenticação ````