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

# Listar llamadas del workspace

> Retorna las llamadas con paginacion por cursor. Incluye grabaciones, duracion y estado.



## OpenAPI

````yaml /openapi.json get /api/v1/vicky/calls
openapi: 3.0.0
info:
  title: WeKall API
  description: >-
    API de WeKall para integraciones externas y automatizacion.


    Conecta tus sistemas con la plataforma WeKall para gestionar agentes de voz
    IA, llamadas, campanas, mensajeria WhatsApp y mas.


    ## Autenticacion


    Usa el endpoint `POST /api/v1/auth/token` con tus credenciales (`client_id`
    + `client_secret`) para obtener un access token. Incluye el token en el
    header `Authorization: Bearer {token}` de cada request.


    ## Productos disponibles


    - **Vicky AI** -- Agentes de voz IA, llamadas, campanas, grabaciones,
    reportes, billing

    - **Messenger Hub** -- WhatsApp, broadcast transaccional, chats, contactos

    - **Notes AI** -- Transcripcion y resumen

    - **Contact Center** -- Gestion de agentes humanos (proximamente)

    - **Business Phone** -- Telefonia cloud PBX (proximamente)


    ## Rate limiting


    100 requests/minuto por IP. El endpoint de autenticacion tiene un limite de
    10 requests/minuto.
  version: '1.0'
  contact: {}
servers:
  - url: https://apis.wekall.co
    description: Produccion
  - url: http://localhost:4001
    description: Local (desarrollo)
security: []
tags:
  - name: Auth
    description: Autenticacion y generacion de tokens
  - name: Vicky AI
    description: Agentes de voz IA, llamadas, campanas, grabaciones, reportes y billing
  - name: Messenger Hub
    description: WhatsApp, broadcast transaccional, chats y contactos
  - name: Notes AI
    description: >-
      Transcripciones de reuniones, conversaciones por vendedor y reuniones
      programadas
paths:
  /api/v1/vicky/calls:
    get:
      tags:
        - Vicky AI
      summary: Listar llamadas del workspace
      description: >-
        Retorna las llamadas con paginacion por cursor. Incluye grabaciones,
        duracion y estado.
      operationId: VickyController_getCalls
      parameters:
        - name: cursor
          required: false
          in: query
          description: Cursor para paginacion (ID del ultimo registro)
          schema:
            type: string
        - name: limit
          required: false
          in: query
          description: Resultados por pagina (max 100)
          schema:
            default: 10
            example: 10
            type: number
        - name: direction
          required: false
          in: query
          description: Direccion de paginacion
          schema:
            default: next
            type: string
            enum:
              - next
              - prev
        - name: agent_name
          required: false
          in: query
          description: Filtrar por nombre de agente
          schema:
            type: string
      responses:
        '200':
          description: Lista de llamadas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCallsResponseDto'
      security:
        - bearer: []
components:
  schemas:
    ListCallsResponseDto:
      type: object
      properties:
        data:
          description: Lista de llamadas
          type: array
          items:
            $ref: '#/components/schemas/CallItemDto'
        total:
          type: number
          example: 635
          description: Total de llamadas
        page:
          type: number
          example: 1
          description: Pagina actual
        totalPages:
          type: number
          example: 64
          description: Total de paginas
      required:
        - data
        - total
        - page
        - totalPages
    CallItemDto:
      type: object
      properties:
        _id:
          type: string
          example: 6a0382ce16365b2f80be4bba
          description: ID de la llamada
        status:
          type: string
          example: done
          enum:
            - done
            - failed
            - in_progress
            - pending
          description: Estado de la llamada
        call_duration_secs:
          type: number
          example: 28
          description: Duracion en segundos
        termination_reason:
          type: string
          example: client_ended_call
          description: Razon de finalizacion
        termination_reason_label:
          type: string
          example: Cliente finalizo llamada
          description: Razon de finalizacion (legible)
        agent_name:
          type: string
          example: Agente Cobranza IA
          description: Nombre del agente
        campaign_name:
          type: string
          example: Campana Diciembre
          description: Nombre de la campana (si aplica)
        caller_id:
          type: string
          example: '+573009137725'
          description: Numero que llamo
        called_number:
          type: string
          example: '+573001234567'
          description: Numero destino
        direction:
          type: string
          example: outbound
          enum:
            - inbound
            - outbound
          description: Direccion de la llamada
        call_file_url:
          type: string
          example: https://...wav
          description: URL de la grabacion
        createdAt:
          type: string
          example: '2026-05-12T19:43:10.502Z'
      required:
        - _id
        - status
        - call_duration_secs
        - termination_reason
        - termination_reason_label
        - agent_name
        - caller_id
        - called_number
        - direction
        - createdAt
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Token obtenido desde POST /api/v1/auth/token

````