Skip to main content
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"

{
  "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"
  }
}

​
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

​
X-API-Key
string
required
Your Mindo API Key. Format: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

​
Path parameters

​
bulk_send_id
string (UUID)
required
Bulk send ID obtained when creating the send with Send bulk.

​
Response

​
id
string (UUID)
Unique bulk send ID.
​
status
string
Current send status. See status table.
​
template
object
Information about the template used.
​
phone_number
object
Information about the sender WhatsApp number.
​
total_recipients
integer
Total send recipients.
​
sent_count
integer
Number of messages sent.
​
delivered_count
integer
Number of messages delivered to the recipient.
​
read_count
integer
Number of messages read by the recipient.
​
failed_count
integer
Number of failed messages.
​
pending_count
integer
Number of messages pending sending.
​
progress_percentage
float
Send progress percentage (0-100).
​
estimated_time_minutes
float
Estimated processing time in minutes.
​
started_at
string (ISO 8601)
Date and time when processing started. null if not yet started.
​
completed_at
string (ISO 8601)
Date and time when processing finished. null if not completed.
​
created_at
string (ISO 8601)
Send creation date and time.
​
created_by
object
User who created the send.
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"
  }
}

​
Possible statuses

StatusDescription
QUEUEDSend created and queued for processing
PROCESSINGActively sending messages
COMPLETEDAll messages processed successfully
PARTIALProcessed with some failures
FAILEDSend failed completely
CANCELLEDSend cancelled manually
To see the detail of each individual message, use the Send messages endpoint.