Skip to main content
GET
/
messages
List messages
curl --request GET \
  --url https://api-message.nativehub.live/api/v1/messages \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "d4e5f6a7-b8c9-0123-def4-567890123456",
      "tenant_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "account_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "from": "+8801912345678",
      "to": "+8801712345678",
      "body": "Your OTP is 123456",
      "status": "delivered",
      "part_count": 1,
      "sell_price": 0.05,
      "cost_price": 0.03,
      "is_encrypted": false,
      "sent_at": "2026-02-14T10:15:30Z",
      "delivered_at": "2026-02-14T10:15:32Z",
      "created_at": "2026-02-14T10:15:28Z",
      "updated_at": "2026-02-14T10:15:32Z"
    }
  ],
  "total": 1543,
  "page": 1,
  "per_page": 20
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
integer
default:1

Page number (default 1)

Required range: x >= 1
​
per_page
integer
default:20

Items per page (default 20, max 100)

Required range: 1 <= x <= 100
​
status
enum<string>

Filter by message status

Available options:
pending,
queued,
submitted,
delivered,
failed,
rejected,
expired
​
from
string

Filter by sender

​
to
string

Filter by recipient

​
date_from
string<date>

Filter messages from this date

​
date_to
string<date>

Filter messages until this date

Response

Messages retrieved successfully

​
data
object[]
​
total
integer
​
page
integer
​
per_page
integer