Skip to main content
GET

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

string
required
Your Mindo API Key. Format: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Path parameters

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

Query parameters

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

Response

integer
Total messages matching the filters.
string | null
URL of the next page of results. null if it’s the last page.
string | null
URL of the previous page. null if it’s the first page.
array
List of individual messages.

Message statuses

Statuses are automatically updated via Meta webhooks. The status progresses from sentdeliveredread. If the send fails, the status will be failed and the error_message field will contain the error description.