Skip to main content
GET
/
api
/
v1
/
meta-templates
/
bulk-sends
/
{bulk_send_id}
/
messages
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/messages/?status=delivered&page=1&page_size=20" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1001,
      "recipient_phone": "+5491112345678",
      "status": "delivered",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgS...",
      "variables_used": {
        "name": "Juan Perez",
        "code": "ABC123"
      },
      "sent_at": "2025-11-16T21:30:10Z",
      "delivered_at": "2025-11-16T21:30:15Z",
      "read_at": null,
      "error_message": null
    },
    {
      "id": 1002,
      "recipient_phone": "+5491187654321",
      "status": "read",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgT...",
      "variables_used": {
        "name": "Maria Garcia",
        "code": "DEF456"
      },
      "sent_at": "2025-11-16T21:30:18Z",
      "delivered_at": "2025-11-16T21:30:23Z",
      "read_at": "2025-11-16T21:30:30Z",
      "error_message": null
    },
    {
      "id": 1003,
      "recipient_phone": "+5491199887766",
      "status": "sent",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgU...",
      "variables_used": {
        "name": "Carlos Lopez",
        "code": "GHI789"
      },
      "sent_at": "2025-11-16T21:30:26Z",
      "delivered_at": null,
      "read_at": null,
      "error_message": null
    }
  ]
}

​
Description

Returns a paginated list of individual messages from a bulk send. Allows filtering by status to quickly identify failed, delivered, or read messages.

​
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.

​
Query parameters

​
status
string
Filter by message status. Possible values: sent, delivered, read, failed.
​
page
integer
Page number. Default: 1.
​
page_size
integer
Results per page. Default: 20.

​
Response

​
count
integer
Total messages 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 individual messages.
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/messages/?status=delivered&page=1&page_size=20" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1001,
      "recipient_phone": "+5491112345678",
      "status": "delivered",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgS...",
      "variables_used": {
        "name": "Juan Perez",
        "code": "ABC123"
      },
      "sent_at": "2025-11-16T21:30:10Z",
      "delivered_at": "2025-11-16T21:30:15Z",
      "read_at": null,
      "error_message": null
    },
    {
      "id": 1002,
      "recipient_phone": "+5491187654321",
      "status": "read",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgT...",
      "variables_used": {
        "name": "Maria Garcia",
        "code": "DEF456"
      },
      "sent_at": "2025-11-16T21:30:18Z",
      "delivered_at": "2025-11-16T21:30:23Z",
      "read_at": "2025-11-16T21:30:30Z",
      "error_message": null
    },
    {
      "id": 1003,
      "recipient_phone": "+5491199887766",
      "status": "sent",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgU...",
      "variables_used": {
        "name": "Carlos Lopez",
        "code": "GHI789"
      },
      "sent_at": "2025-11-16T21:30:26Z",
      "delivered_at": null,
      "read_at": null,
      "error_message": null
    }
  ]
}

​
Message statuses

StatusDescription
sentMessage sent to the Meta API
deliveredMessage delivered to the recipient
readMessage read by the recipient
failedSend error
Statuses are automatically updated via Meta webhooks. The status progresses from sent → delivered → read. If the send fails, the status will be failed and the error_message field will contain the error description.