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

# Lista de envíos programados

> Lista los envíos programados del dispositivo. Las próximas semanas vienen primero (antes la próxima carrera), seguido de las terminadas, las más recientes primero.



## OpenAPI

````yaml /es/openapi.yml get /send/schedules
openapi: 3.0.0
info:
  title: Multidispositivo API de WhatsApp
  version: 9.7.0
  description: >
    Esta API se utiliza para enviar whatsapp a través de API.


    El panel web es un proyecto separado (gowa-ui); el servidor descarga su
    último recurso de versión

    y lo sirve en `/` (o devuelve un banner JSON cuando

    APP_UI_ENABLED=false).


    Ámbito del dispositivo:

    - Envía `X-Device-Id` en todas las llamadas REST con ámbito dispositivo.

    - WebSocket: conectar a `/ws?device_id=<id>`.

    - WebSocket auth (cuando la autenticación básica está habilitada): los
    navegadores no pueden establecer un encabezado
      de autorización en conexiones WebSocket, así que también pase
      `&authorization=<base64(user:pass)>` en la cadena de consulta. Usa TLS en producciónformat@@0
      ya que la credencial es visible en la URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Conexión inicial al servidor de Whatsapp
  - name: device
    description: Gestión de dispositivos para soporte multidispositivo
  - name: user
    description: Obteniendo información
  - name: send
    description: Enviar mensaje (Texto/Imágen/Archivo/Video).
  - name: message
    description: Manipulación de mensajes (revocar/react/actualizar).
  - name: call
    description: Gestión de llamadas (rechazar llamadas entrantes)
  - name: chat
    description: Chats de chat y mensajería
  - name: group
    description: Ajuste de grupo
  - name: newsletter
    description: configuración del boletín de noticias
  - name: chatwoot
    description: Integración de Chatwoot para soporte al cliente
paths:
  /send/schedules:
    get:
      tags:
        - send
      summary: Lista de envíos programados
      description: >-
        Lista los envíos programados del dispositivo. Las próximas semanas
        vienen primero (antes la próxima carrera), seguido de las terminadas,
        las más recientes primero.
      operationId: listScheduledSends
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - name: status
          in: query
          schema:
            type: string
            enum:
              - active
              - running
              - paused
              - completed
              - failed
              - cancelled
          description: Sólo los programas en este estado
        - name: search
          in: query
          schema:
            type: string
          description: Coincidir con el destinatario o el texto del mensaje
        - name: message_type
          in: query
          schema:
            type: string
            enum:
              - text
              - image
              - file
              - video
              - audio
              - sticker
              - contact
              - link
              - location
              - poll
              - forward
          description: Sólo este tipo de envío programado
        - name: limit
          in: query
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
          description: Número máximo de programas a devolver
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
          description: Número de programas a omitir (para paginación)
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleListResponse'
        '400':
          description: >-
            Solicitud incorrecta (por ejemplo, estado desconocido o
            message_type, límite o desplazamiento fuera de rango)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Identificador de dispositivo para soporte multidispositivo. Requerido
        cuando se registran múltiples dispositivos.

        Si sólo se registra un dispositivo, se utilizará como el valor
        predeterminado.

        También se puede proporcionar como parámetro de consulta `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    ScheduleListResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Schedules fetched
        results:
          type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/Schedule'
            pagination:
              type: object
              properties:
                limit:
                  type: integer
                  example: 25
                offset:
                  type: integer
                  example: 0
                total:
                  type: integer
                  example: 3
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: Código de estado HTTP
        message:
          type: string
          example: field cannot be blank
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: Error
        message:
          type: string
          example: you are not loggin
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    Schedule:
      type: object
      properties:
        id:
          type: string
          example: 0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10
        message_type:
          type: string
          enum:
            - text
            - image
            - file
            - video
            - audio
            - sticker
            - contact
            - link
            - location
            - poll
            - forward
          example: text
        phone:
          type: string
          example: 6289685028129@s.whatsapp.net
        summary:
          type: string
          example: selamat pagi
          description: Vista rápida del mensaje
        status:
          type: string
          enum:
            - active
            - running
            - paused
            - completed
            - failed
            - cancelled
          example: active
          description: >
            - `active`: en espera de su próxima ejecución

            - `running`: asignado al proceso de trabajo y enviando

            - `paused`: en espera hasta que se reanude

            - `completed`: no quedan ejecuciones

            - `failed`: se ha abandonado tras los reintentos o un error de
            validación

            - `cancelled`: cancelado por el usuario
        scheduled_at:
          type: string
          format: date-time
          example: '2026-10-01T02:00:00Z'
        next_run_at:
          type: string
          format: date-time
          example: '2026-10-01T02:00:00Z'
          description: Omitido cuando no queda ejecución
        timezone:
          type: string
          example: Asia/Jakarta
        recurrence:
          type: string
          enum:
            - once
            - daily
            - weekly
            - monthly
          example: once
        weekdays:
          type: array
          items:
            type: integer
          example:
            - 1
            - 3
            - 5
        day_of_month:
          type: integer
          example: 15
        end_at:
          type: string
          format: date-time
        occurrence_limit:
          type: integer
          example: 10
        occurrence_count:
          type: integer
          example: 0
          description: Número de envíos exitosos hasta ahora
        attempts:
          type: integer
          example: 0
          description: Intentos fallidos para la ejecución actual
        last_run_at:
          type: string
          format: date-time
        last_message_id:
          type: string
          example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
        last_error:
          type: string
        created_at:
          type: string
          format: date-time
          example: '2026-09-25T08:00:00Z'
        updated_at:
          type: string
          format: date-time
          example: '2026-09-25T08:00:00Z'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Envíos programados](https://gowa-docs.mintlify.site/es/examples/scheduled-sends.md)
- [Pausar un envío programado](https://gowa-docs.mintlify.site/es/api-reference/send/pausar-un-envío-programado.md)
- [Reanudar un envío programado](https://gowa-docs.mintlify.site/es/api-reference/send/reanudar-un-envío-programado.md)
- [Cancelar un envío programado](https://gowa-docs.mintlify.site/es/api-reference/send/cancelar-un-envío-programado.md)
- [Obtener un envío programado](https://gowa-docs.mintlify.site/es/api-reference/send/obtener-un-envío-programado.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.