> ## Documentation Index > Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Listar bots disponibles > Devuelve un listado de todos los bots disponibles asociados al usuario autenticado. Incluye información del tipo de bot, tipo de conversación y su última campaña conocida. ## OpenAPI ````yaml GET /api/v2/bots/ openapi: 3.0.0 info: title: API Inceptia description: API para la consulta de campañas, casos y llamadas de un bot. version: 2.0.0 servers: - url: https://admintest.inceptia.ai/ description: Ambiente de pruebas - url: https://admin.inceptia.ai/ description: Ambiente productivo security: [] tags: - name: Autenticación description: Endpoints para la autenticación de usuarios y gestión de tokens. - name: Bots description: Endpoints para operaciones relacionadas con los bots. - name: Campañas description: Endpoints para operaciones relacionadas con las campañas. - name: Casos de campaña description: Endpoints para operaciones relacionadas con los casos de campaña. - name: Llamadas de campaña description: Endpoints para operaciones relacionadas con las llamadas de campaña. - name: Casos de inbound description: Endpoints para operaciones relacionadas con los casos de inbound. paths: /api/v2/bots/: get: tags: - Bots summary: Listar bots disponibles description: > Devuelve un listado de todos los bots disponibles asociados al usuario autenticado. Incluye información del tipo de bot, tipo de conversación y su última campaña conocida. responses: '200': description: Lista de bots obtenida exitosamente. content: application/json: schema: type: array items: $ref: '#/components/schemas/BotSummary' example: - id: 101 name: Demo_Bot_Voz alias: Demo_Bot_Voz business_group_name: Grupo_Test internal_tags: [] external_tags: [] bot_type: OUTBOUND conversation_type: VOICE last_campaign: name: Campaña Test Octubre status: CLOSED percentage_completed: 100 percentage_called: 100 q_final_cases: 15 q_loaded_cases: 15 contactability: 90 max_calls_per_case: 3 phone_priority: 2 dialing_type: HORIZONTAL_VERTICAL call_from: '09:00:00' call_to: '21:00:00' start_date: '2024-10-15' workers: 120 bot_status_last: {} error: 0 active_wks: 0 inactive_wks: 0 - id: 102 name: Demo_Bot_Whatsapp alias: Demo_Bot_Whatsapp business_group_name: '' internal_tags: [] external_tags: [] bot_type: INBOUND conversation_type: WHATSAPP last_campaign: {} bot_status_last: cases_in_progress: 0 total_cases: 0 case_distribution: ended_without_error: 0 ended_with_error: 0 error: 0 active_wks: 0 inactive_wks: 0 '401': description: No autorizado. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' security: - jwtAuth: [] components: schemas: BotSummary: type: object properties: id: type: integer name: type: string alias: type: string business_group_name: type: string nullable: true internal_tags: type: array items: type: string external_tags: type: array items: type: string bot_type: type: string enum: - INBOUND - OUTBOUND conversation_type: type: string enum: - VOICE - WHATSAPP last_campaign: $ref: '#/components/schemas/BotLastCampaign' bot_status_last: $ref: '#/components/schemas/BotStatusLast' error: type: integer active_wks: type: integer inactive_wks: type: integer example: id: 101 name: Demo_Bot_Voz alias: Demo_Bot_Voz business_group_name: Grupo_Test internal_tags: [] external_tags: [] bot_type: OUTBOUND conversation_type: VOICE last_campaign: name: Campaña Test Octubre status: CLOSED percentage_completed: 100 percentage_called: 100 q_final_cases: 15 q_loaded_cases: 15 contactability: 90 max_calls_per_case: 3 phone_priority: 2 dialing_type: HORIZONTAL_VERTICAL call_from: '09:00:00' call_to: '21:00:00' start_date: '2024-10-15' workers: 120 bot_status_last: {} error: 0 active_wks: 0 inactive_wks: 0 UnauthorizedError: type: object properties: token: type: string example: token: El token es inválido o ha expirado BotLastCampaign: type: object description: Última campaña asociada al bot (si existe). properties: name: type: string description: Nombre de la campaña. status: type: string description: Estado actual de la campaña (ej. CLOSED, ONGOING, PAUSED). percentage_completed: type: integer description: Porcentaje completado de la campaña. percentage_called: type: integer description: Porcentaje de casos llamados. q_final_cases: type: integer description: Cantidad de casos finalizados. q_loaded_cases: type: integer description: Total de casos cargados. contactability: type: integer description: Porcentaje de contactabilidad. max_calls_per_case: type: integer description: Límite de reintentos por caso. phone_priority: type: integer description: Prioridad máxima de teléfono. dialing_type: type: string description: Modo de discado (VERTICAL, HORIZONTAL_VERTICAL). call_from: type: string format: time call_to: type: string format: time start_date: type: string format: date workers: type: integer example: name: Campaña Test Octubre status: CLOSED percentage_completed: 100 percentage_called: 100 q_final_cases: 15 q_loaded_cases: 15 contactability: 90 max_calls_per_case: 3 phone_priority: 2 dialing_type: HORIZONTAL_VERTICAL call_from: '09:00:00' call_to: '21:00:00' start_date: '2024-10-15' workers: 120 BotStatusLast: type: object description: Estado operativo reciente del bot (solo para bots activos o inbound). properties: cases_in_progress: type: integer total_cases: type: integer case_distribution: type: object description: Distribución de resultados de casos. additionalProperties: true example: cases_in_progress: 1 total_cases: 10 case_distribution: ended_without_error: 9 ended_with_error: 1 securitySchemes: jwtAuth: type: http scheme: bearer bearerFormat: JWT description: Token de acceso JWT. Debe ser enviado como 'Bearer {token}'. ````