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"Status: {data['status']}")
print(f"Progress: {data['progress_percentage']}%")
print(f"Sent: {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(`Status: ${data.status}`);
console.log(`Progress: ${data.progress_percentage}%`);
console.log(`Sent: ${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)"
}
Bulk sending
Send status
Check the status and progress of a bulk send
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"Status: {data['status']}")
print(f"Progress: {data['progress_percentage']}%")
print(f"Sent: {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(`Status: ${data.status}`);
console.log(`Progress: ${data.progress_percentage}%`);
console.log(`Sent: ${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)"
}
Description
Allows you to check the current status and detailed progress of a bulk send. Includes counters for sent, delivered, read, and failed messages, plus the progress percentage.Authentication header
string
required
Your Mindo API Key. Format:
mindo_xxxxxxxxxxxxxxxxxxxxxxxxPath parameters
Response
string (UUID)
Unique bulk send ID.
string
Current send status. See status table.
object
object
integer
Total send recipients.
integer
Number of messages sent.
integer
Number of messages delivered to the recipient.
integer
Number of messages read by the recipient.
integer
Number of failed messages.
integer
Number of messages pending sending.
float
Send progress percentage (0-100).
float
Estimated processing time in minutes.
string (ISO 8601)
Date and time when processing started.
null if not yet started.string (ISO 8601)
Date and time when processing finished.
null if not completed.string (ISO 8601)
Send creation date and time.
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"Status: {data['status']}")
print(f"Progress: {data['progress_percentage']}%")
print(f"Sent: {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(`Status: ${data.status}`);
console.log(`Progress: ${data.progress_percentage}%`);
console.log(`Sent: ${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)"
}
Possible statuses
| Status | Description |
|---|---|
QUEUED | Send created and queued for processing |
PROCESSING | Actively sending messages |
COMPLETED | All messages processed successfully |
PARTIAL | Processed with some failures |
FAILED | Send failed completely |
CANCELLED | Send cancelled manually |
To see the detail of each individual message, use the Send messages endpoint.

