Skip to content

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/loginfo

Content 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).

PropertyTypeRequiredDescription
messageIdstringOptionalSystem message ID (smsId in the result) — matches details[].messageId from Send SMS only when you did not set your own messageId
mobilestringOptionalRecipient number, exact match in the form 66XXXXXXXXX, e.g. 66812345678 (not normalized for you)
bulkIdstringOptionalbulkId from Send SMS (for OTP it is the otpId)
dateFromstringOptionalStart 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)
dateTostringOptionalEnd time, RFC3339 or YYYY-MM-DD (= end of that day in UTC)
pageintegerOptionalPage number, starting at 1 (default 1)
pageSizeintegerOptionalRecords 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 ​

PropertyTypeDescription
statusnumber200
dataarray of LogRecords on this page (null when nothing matches)
totalRecordnumberTotal records matching the filters
pagenumberCurrent page
pageSizenumberRecords per page

Log ​

PropertyTypeDescription
smsIdstringSystem message ID
accountIdnumberAccount ID
userIdnumberID of the sending user
bulkIdstringBatch ID (omitted when empty)
campaignIdstringCampaign ID (only on some records)
fromstringSender name
tostringRecipient 66XXXXXXXXX
textstringMessage text (OTP codes are masked)
statusnumberStatus, see Status
statusCodestringDetailed status code (from the platform or the mobile operator)
statusDescriptionstringOperator's result description (present once a delivery report arrives)
smsTypenumberMessage type
creditnumberCredit used (0 for rejected records)
gatewayobjectRoute info: name (route name), ackId (operator reference), operatorCode (operator result code)
notifyUrlstringDelivery Report URL (if set)
sentAtstringTime submitted to the operator (ISO 8601)
deliveredAtstringTime delivered to the handset (present when status = 3)
createdAtstringRecord creation time (ISO 8601)
updatedAtstringLast update time (ISO 8601)

Status ​

statusMeaningTypical statusCode
1Sent — submitted to the mobile operator, awaiting handset deliveryOperator acknowledgement code
2Failed — the platform could not send itVALIDATION_ERROR, SEND_ERROR
3Delivered — delivered to the handsetOperator code
4Rejected — account is on hold91
5Rejected — number is blacklisted / recipient opted out / no consent92, SUPPRESSED, NO_CONSENT
6Rejected — account daily send limit exceeded512
7Rejected — sender name not authorized101
9Failed — empty text, or the operator reported the message undelivered107 or operator code

TIP

  • Records appear once the queue has been processed (not the instant Send SMS replies)
  • Recipients rejected at Send SMS time (e.g. 402 invalid number) have no log record

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.

HTTPResponseCause
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