SMS Log Info GET
Searches your account's SMS send history and status (including SMS sent via Send SMS and OTP), paginated, newest first.
Authorization
API Key (Authentication) in the header Authorization: Bearer <API_KEY>.
HTTP Request
http
GET https://public-api.smsup-plus.com/sms/loginfoContent Type
No body — filters go in the query string.
Parameter Description
All parameters are optional. With none, you get every record of the account (first page, 20 records).
| Property | Type | Required | Description |
|---|---|---|---|
messageId | string | Optional | System message ID (smsId in the result) — matches details[].messageId from Send SMS only when you did not set your own messageId |
mobile | string | Optional | Recipient number, exact match in the form 66XXXXXXXXX, e.g. 66812345678 (not normalized for you) |
bulkId | string | Optional | bulkId from Send SMS (for OTP it is the otpId) |
dateFrom | string | Optional | Start time (by record creation time), RFC3339 e.g. 2026-11-01T00:00:00+07:00, or YYYY-MM-DD (= 00:00:00 UTC of that day) |
dateTo | string | Optional | End time, RFC3339 or YYYY-MM-DD (= end of that day in UTC) |
page | integer | Optional | Page number, starting at 1 (default 1) |
pageSize | integer | Optional | Records per page, 1–100 (default 20; out-of-range values fall back to 20) |
Date format
If dateFrom / dateTo has a bad format, no error is returned — the filter is simply ignored. Use RFC3339 with +07:00 to get the correct Thailand-time range.
Response Description
| Property | Type | Description |
|---|---|---|
status | number | 200 |
data | array of Log | Records on this page (null when nothing matches) |
totalRecord | number | Total records matching the filters |
page | number | Current page |
pageSize | number | Records per page |
Log
| Property | Type | Description |
|---|---|---|
smsId | string | System message ID |
accountId | number | Account ID |
userId | number | ID of the sending user |
bulkId | string | Batch ID (omitted when empty) |
campaignId | string | Campaign ID (only on some records) |
from | string | Sender name |
to | string | Recipient 66XXXXXXXXX |
text | string | Message text (OTP codes are masked) |
status | number | Status, see Status |
statusCode | string | Detailed status code (from the platform or the mobile operator) |
statusDescription | string | Operator's result description (present once a delivery report arrives) |
smsType | number | Message type |
credit | number | Credit used (0 for rejected records) |
gateway | object | Route info: name (route name), ackId (operator reference), operatorCode (operator result code) |
notifyUrl | string | Delivery Report URL (if set) |
sentAt | string | Time submitted to the operator (ISO 8601) |
deliveredAt | string | Time delivered to the handset (present when status = 3) |
createdAt | string | Record creation time (ISO 8601) |
updatedAt | string | Last update time (ISO 8601) |
Status
status | Meaning | Typical statusCode |
|---|---|---|
1 | Sent — submitted to the mobile operator, awaiting handset delivery | Operator acknowledgement code |
2 | Failed — the platform could not send it | VALIDATION_ERROR, SEND_ERROR |
3 | Delivered — delivered to the handset | Operator code |
4 | Rejected — account is on hold | 91 |
5 | Rejected — number is blacklisted / recipient opted out / no consent | 92, SUPPRESSED, NO_CONSENT |
6 | Rejected — account daily send limit exceeded | 512 |
7 | Rejected — sender name not authorized | 101 |
9 | Failed — empty text, or the operator reported the message undelivered | 107 or operator code |
TIP
Request Example
bash
curl -G 'https://public-api.smsup-plus.com/sms/loginfo' \
-H 'Authorization: Bearer <API_KEY>' \
--data-urlencode 'bulkId=3b0f5c7e-8d2a-4c61-9e3f-1a2b3c4d5e6f' \
--data-urlencode 'dateFrom=2026-11-01T00:00:00+07:00' \
--data-urlencode 'page=1' \
--data-urlencode 'pageSize=50'js
const params = new URLSearchParams({
bulkId: '3b0f5c7e-8d2a-4c61-9e3f-1a2b3c4d5e6f',
dateFrom: '2026-11-01T00:00:00+07:00',
page: '1',
pageSize: '50',
})
const res = await fetch(`https://public-api.smsup-plus.com/sms/loginfo?${params}`, {
headers: { Authorization: 'Bearer <API_KEY>' },
})
console.log(await res.json())Response Example
json
{
"status": 200,
"data": [
{
"smsId": "9c8e2f1a-4b7d-4e0a-8f6c-2d1e0b9a8c7d",
"accountId": 1024,
"userId": 2048,
"bulkId": "3b0f5c7e-8d2a-4c61-9e3f-1a2b3c4d5e6f",
"from": "MyBrand",
"to": "66812345678",
"text": "Your order has been shipped",
"status": 3,
"statusCode": "000",
"statusDescription": "Delivered",
"smsType": 0,
"credit": 1,
"gateway": { "name": "ROUTE1", "ackId": "A1B2C3D4", "operatorCode": "000" },
"notifyUrl": "https://example.com/sms/dr",
"sentAt": "2026-11-16T02:00:01.12Z",
"deliveredAt": "2026-11-16T02:00:05.48Z",
"createdAt": "2026-11-16T02:00:01.12Z",
"updatedAt": "2026-11-16T02:00:05.48Z"
}
],
"totalRecord": 1,
"page": 1,
"pageSize": 50
}Possible Errors
See Error Codes for the overview.
| HTTP | Response | Cause |
|---|---|---|
| 401 | {"error":{"statusCode":"401","description":"Invalid account","message":"UNAUTHORIZED"}} | No account could be resolved from the credentials |
| 429 | {"error":{"statusCode":"429","description":"rate limit exceeded: max 50 requests per second per account","message":"TOO_MANY_REQUESTS"}} | Too many requests — wait as told by Retry-After |
| 500 | {"error":{"statusCode":"500","description":"Failed to query SMS logs","message":"INTERNAL_ERROR"}} | Temporary failure while querying |
