curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
-H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
import requests
bulk_send_id = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
response = requests.get(
f"https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/{bulk_send_id}/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)
data = response.json()
print(f"Estado: {data['status']}")
print(f"Progreso: {data['progress_percentage']}%")
print(f"Enviados: {data['sent_count']}/{data['total_recipients']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Estado: ${data.status}`);
console.log(`Progreso: ${data.progress_percentage}%`);
console.log(`Enviados: ${data.sent_count}/${data.total_recipients}`);
{
"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"
}
}
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "PROCESSING",
"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": 100,
"sent_count": 45,
"delivered_count": 30,
"read_count": 10,
"failed_count": 2,
"pending_count": 53,
"progress_percentage": 47.0,
"estimated_time_minutes": 6.0,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": null,
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
Envío masivo
Estado del envío
Consultar el estado y progreso de un envío masivo
GET
/
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"
import requests
bulk_send_id = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
response = requests.get(
f"https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/{bulk_send_id}/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)
data = response.json()
print(f"Estado: {data['status']}")
print(f"Progreso: {data['progress_percentage']}%")
print(f"Enviados: {data['sent_count']}/{data['total_recipients']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Estado: ${data.status}`);
console.log(`Progreso: ${data.progress_percentage}%`);
console.log(`Enviados: ${data.sent_count}/${data.total_recipients}`);
{
"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"
}
}
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "PROCESSING",
"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": 100,
"sent_count": 45,
"delivered_count": 30,
"read_count": 10,
"failed_count": 2,
"pending_count": 53,
"progress_percentage": 47.0,
"estimated_time_minutes": 6.0,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": null,
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
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
string
requerido
Tu API Key de Mindo. Formato:
mindo_xxxxxxxxxxxxxxxxxxxxxxxxParámetros de ruta
string (UUID)
requerido
ID del envío masivo obtenido al crear el envío con Enviar masivo.
Respuesta
string (UUID)
ID único del envío masivo.
string
Estado actual del envío. Ver tabla de estados.
object
object
integer
Total de destinatarios del envío.
integer
Cantidad de mensajes enviados.
integer
Cantidad de mensajes entregados al destinatario.
integer
Cantidad de mensajes leídos por el destinatario.
integer
Cantidad de mensajes fallidos.
integer
Cantidad de mensajes pendientes de envío.
float
Porcentaje de progreso del envío (0-100).
float
Tiempo estimado de procesamiento en minutos.
string (ISO 8601)
Fecha y hora en que comenzó el procesamiento.
null si aún no inició.string (ISO 8601)
Fecha y hora en que finalizó el procesamiento.
null si no completó.string (ISO 8601)
Fecha y hora de creación del envío.
object
curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
-H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
import requests
bulk_send_id = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
response = requests.get(
f"https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/{bulk_send_id}/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)
data = response.json()
print(f"Estado: {data['status']}")
print(f"Progreso: {data['progress_percentage']}%")
print(f"Enviados: {data['sent_count']}/{data['total_recipients']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Estado: ${data.status}`);
console.log(`Progreso: ${data.progress_percentage}%`);
console.log(`Enviados: ${data.sent_count}/${data.total_recipients}`);
{
"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"
}
}
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "PROCESSING",
"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": 100,
"sent_count": 45,
"delivered_count": 30,
"read_count": 10,
"failed_count": 2,
"pending_count": 53,
"progress_percentage": 47.0,
"estimated_time_minutes": 6.0,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": null,
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
Estados posibles
| Estado | Descripción |
|---|---|
QUEUED | Envío creado y en cola de procesamiento |
PROCESSING | Enviando mensajes activamente |
COMPLETED | Todos los mensajes procesados exitosamente |
PARTIAL | Procesado con algunos fallos |
FAILED | El envío falló completamente |
CANCELLED | Envío cancelado manualmente |
Para ver el detalle de cada mensaje individual, usá el endpoint Mensajes del envío.

