Developer documentation

List endpoints, such as batches, messages, groups and contacts, return one page at a time.

Query parameters

GET https://e-amarseba.com/api/v1/bulk-sms/messages?status=failed&page=2&per_page=50

The pagination block

data holds the items as a list, and a top-level pagination object describes the page. Keep requesting the next page while has_more_pages is true.

{
    "success": true,
    "message": "Request successful",
    "data": [
        { "message_id": "msg_01j8z3k6qa4b8c2d6e0f3g7h1j", "to": "8801712345678", "status": "failed", "refunded": true }
    ],
    "code": 200,
    "timestamp": "2026-09-26T10:00:00.000000Z",
    "pagination": {
        "current_page": 2,
        "per_page": 50,
        "total": 173,
        "last_page": 4,
        "has_more_pages": true,
        "from": 51,
        "to": 100
    }
}