Skip to main content
GET
https://api.mindosoftware.com
/
api
/
v1
/
meta-templates
/
bulk-sends
/
{bulk_send_id}
curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
{
  "id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "status": "COMPLETED",
  "template": {
    "id": 45,
    "template_name": "welcome_message",
    "language": "es",
    "status": "APPROVED"
  },
  "phone_number": {
    "id": 123,
    "display_phone_number": "+54 9 223 675-0780",
    "verified_name": "Mindo Software"
  },
  "total_recipients": 3,
  "sent_count": 3,
  "delivered_count": 2,
  "read_count": 1,
  "failed_count": 0,
  "pending_count": 0,
  "progress_percentage": 100.0,
  "estimated_time_minutes": 0.4,
  "started_at": "2025-11-16T21:30:05Z",
  "completed_at": "2025-11-16T21:30:28Z",
  "created_at": "2025-11-16T21:30:00Z",
  "created_by": {
    "id": 1,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  }
}

Descripción

Permite consultar el estado actual y el progreso detallado de un envío masivo. Incluye contadores de mensajes enviados, entregados, leídos y fallidos, además del porcentaje de progreso.

Header de autenticación

X-API-Key
string
required
Tu API Key de Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Parámetros de ruta

bulk_send_id
string (UUID)
required
ID del envío masivo obtenido al crear el envío con Enviar masivo.

Respuesta

id
string (UUID)
ID único del envío masivo.
status
string
Estado actual del envío. Ver tabla de estados.
template
object
Información del template utilizado.
phone_number
object
Información del número de WhatsApp emisor.
total_recipients
integer
Total de destinatarios del envío.
sent_count
integer
Cantidad de mensajes enviados.
delivered_count
integer
Cantidad de mensajes entregados al destinatario.
read_count
integer
Cantidad de mensajes leídos por el destinatario.
failed_count
integer
Cantidad de mensajes fallidos.
pending_count
integer
Cantidad de mensajes pendientes de envío.
progress_percentage
float
Porcentaje de progreso del envío (0-100).
estimated_time_minutes
float
Tiempo estimado de procesamiento en minutos.
started_at
string (ISO 8601)
Fecha y hora en que comenzó el procesamiento. null si aún no inició.
completed_at
string (ISO 8601)
Fecha y hora en que finalizó el procesamiento. null si no completó.
created_at
string (ISO 8601)
Fecha y hora de creación del envío.
created_by
object
Usuario que creó el envío.
curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
{
  "id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "status": "COMPLETED",
  "template": {
    "id": 45,
    "template_name": "welcome_message",
    "language": "es",
    "status": "APPROVED"
  },
  "phone_number": {
    "id": 123,
    "display_phone_number": "+54 9 223 675-0780",
    "verified_name": "Mindo Software"
  },
  "total_recipients": 3,
  "sent_count": 3,
  "delivered_count": 2,
  "read_count": 1,
  "failed_count": 0,
  "pending_count": 0,
  "progress_percentage": 100.0,
  "estimated_time_minutes": 0.4,
  "started_at": "2025-11-16T21:30:05Z",
  "completed_at": "2025-11-16T21:30:28Z",
  "created_at": "2025-11-16T21:30:00Z",
  "created_by": {
    "id": 1,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  }
}

Estados posibles

EstadoDescripción
QUEUEDEnvío creado y en cola de procesamiento
PROCESSINGEnviando mensajes activamente
COMPLETEDTodos los mensajes procesados exitosamente
PARTIALProcesado con algunos fallos
FAILEDEl envío falló completamente
CANCELLEDEnvío cancelado manualmente
Para ver el detalle de cada mensaje individual, usá el endpoint Mensajes del envío.