Skip to main content
GET
/
api
/
v1
/
meta-templates
/
bulk-sends
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?status=COMPLETED&created_after=2025-11-01&page=1&page_size=10" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "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,
      "created_at": "2025-11-16T21:30:00Z",
      "completed_at": "2025-11-16T21:30:28Z"
    },
    {
      "id": "b4c3d9e0-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
      "status": "COMPLETED",
      "template": {
        "id": 46,
        "template_name": "order_confirmation",
        "language": "es",
        "status": "APPROVED"
      },
      "phone_number": {
        "id": 123,
        "display_phone_number": "+54 9 223 675-0780",
        "verified_name": "Mindo Software"
      },
      "total_recipients": 150,
      "sent_count": 150,
      "delivered_count": 142,
      "read_count": 98,
      "failed_count": 0,
      "pending_count": 0,
      "progress_percentage": 100.0,
      "created_at": "2025-11-15T14:00:00Z",
      "completed_at": "2025-11-15T14:09:30Z"
    }
  ]
}

​
Description

Returns a paginated list of all bulk sends. Supports filters by status, template, and date range for easy searching.

​
Authentication header

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

​
Query parameters

​
status
string
Filter by send status. Possible values: QUEUED, PROCESSING, COMPLETED, PARTIAL, FAILED, CANCELLED.
​
template
integer
Filter by template ID used.
​
created_after
string (date)
Filter sends created after this date. Format: YYYY-MM-DD.
​
created_before
string (date)
Filter sends created before this date. Format: YYYY-MM-DD.
​
page
integer
Page number. Default: 1.
​
page_size
integer
Results per page. Default: 20.

​
Response

​
count
integer
Total bulk sends matching the filters.
​
next
string | null
URL of the next page of results. null if it’s the last page.
​
previous
string | null
URL of the previous page. null if it’s the first page.
​
results
array
List of bulk sends.
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?status=COMPLETED&created_after=2025-11-01&page=1&page_size=10" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "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,
      "created_at": "2025-11-16T21:30:00Z",
      "completed_at": "2025-11-16T21:30:28Z"
    },
    {
      "id": "b4c3d9e0-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
      "status": "COMPLETED",
      "template": {
        "id": 46,
        "template_name": "order_confirmation",
        "language": "es",
        "status": "APPROVED"
      },
      "phone_number": {
        "id": 123,
        "display_phone_number": "+54 9 223 675-0780",
        "verified_name": "Mindo Software"
      },
      "total_recipients": 150,
      "sent_count": 150,
      "delivered_count": 142,
      "read_count": 98,
      "failed_count": 0,
      "pending_count": 0,
      "progress_percentage": 100.0,
      "created_at": "2025-11-15T14:00:00Z",
      "completed_at": "2025-11-15T14:09:30Z"
    }
  ]
}