SMS Log Info GET
ใช้ค้นประวัติและสถานะการส่ง SMS ของบัญชี (รวม SMS ที่ส่งจาก ส่ง SMS และ OTP) แบบแบ่งหน้า เรียงจากรายการใหม่สุดก่อน
Authorization
ใช้ API Key (การยืนยันตัวตน) ส่งใน header Authorization: Bearer <API_KEY>
HTTP Request
http
GET https://public-api.smsup-plus.com/sms/loginfoContent Type
ไม่มี body — ส่งเงื่อนไขเป็น query string
Parameter Description
ทุกพารามิเตอร์ไม่บังคับ ถ้าไม่ส่งเลยจะได้ทุกรายการของบัญชี (หน้าแรก 20 รายการ)
| Property | Type | Required | Description |
|---|---|---|---|
messageId | string | Optional | ค้นด้วยรหัสข้อความของระบบ (smsId ในผลลัพธ์) — ตรงกับ details[].messageId จาก ส่ง SMS เฉพาะกรณีที่คุณ ไม่ได้ กำหนด messageId เอง |
mobile | string | Optional | เบอร์ปลายทาง ต้องตรงทุกตัวในรูปแบบ 66XXXXXXXXX เช่น 66812345678 (ระบบไม่แปลงรูปแบบให้) |
bulkId | string | Optional | bulkId จาก ส่ง SMS (สำหรับ OTP คือ otpId) |
dateFrom | string | Optional | วันเวลาเริ่ม (นับจากเวลาที่บันทึกรายการ) รูปแบบ RFC3339 เช่น 2026-11-01T00:00:00+07:00 หรือ YYYY-MM-DD (= 00:00:00 UTC ของวันนั้น) |
dateTo | string | Optional | วันเวลาสิ้นสุด รูปแบบ RFC3339 หรือ YYYY-MM-DD (= สิ้นวันนั้นตามเวลา UTC) |
page | integer | Optional | หน้าที่ต้องการ เริ่มที่ 1 (ค่าเริ่มต้น 1) |
pageSize | integer | Optional | จำนวนต่อหน้า 1–100 (ค่าเริ่มต้น 20; ค่านอกช่วงจะใช้ 20) |
รูปแบบวันที่
ถ้า dateFrom / dateTo ผิดรูปแบบ ระบบ ไม่แจ้ง error แต่จะไม่ใช้เงื่อนไขนั้น — ส่งแบบ RFC3339 พร้อม +07:00 เพื่อให้ได้ช่วงเวลาไทยที่ถูกต้อง
Response Description
| Property | Type | Description |
|---|---|---|
status | number | 200 |
data | array of Log | รายการในหน้านี้ (null เมื่อไม่พบข้อมูล) |
totalRecord | number | จำนวนรายการทั้งหมดที่ตรงเงื่อนไข |
page | number | หน้าปัจจุบัน |
pageSize | number | จำนวนต่อหน้า |
Log
| Property | Type | Description |
|---|---|---|
smsId | string | รหัสข้อความของระบบ |
accountId | number | รหัสบัญชี |
userId | number | รหัสผู้ใช้ที่ส่ง |
bulkId | string | รหัสกลุ่มการส่ง (ไม่มีฟิลด์นี้ถ้าไม่มีค่า) |
campaignId | string | รหัสแคมเปญ (มีเฉพาะบางรายการ) |
from | string | ชื่อผู้ส่ง |
to | string | เบอร์ปลายทาง 66XXXXXXXXX |
text | string | ข้อความ (ข้อความ OTP จะถูกปิดรหัส) |
status | number | สถานะ ดู ตารางสถานะ |
statusCode | string | รหัสสถานะละเอียด (จากระบบหรือผู้ให้บริการเครือข่าย) |
statusDescription | string | คำอธิบายผลจากผู้ให้บริการเครือข่าย (มีเมื่อได้รับ Delivery Report) |
smsType | number | ประเภทข้อความ |
credit | number | เครดิตที่ใช้ (0 สำหรับรายการที่ถูกปฏิเสธ) |
gateway | object | ข้อมูลเส้นทางส่ง: name (ชื่อเส้นทาง), ackId (รหัสอ้างอิงจากผู้ให้บริการ), operatorCode (รหัสผลจากผู้ให้บริการ) |
notifyUrl | string | URL สำหรับ Delivery Report (ถ้ากำหนดไว้) |
sentAt | string | เวลาที่ส่งไปยังผู้ให้บริการเครือข่าย (ISO 8601) |
deliveredAt | string | เวลาที่ส่งถึงเครื่องผู้รับ (มีเมื่อ status = 3) |
createdAt | string | เวลาที่บันทึกรายการ (ISO 8601) |
updatedAt | string | เวลาที่อัปเดตล่าสุด (ISO 8601) |
สถานะ
status | ความหมาย | statusCode ที่พบ |
|---|---|---|
1 | Sent — ส่งถึงผู้ให้บริการเครือข่ายแล้ว รอผลการส่งถึงเครื่อง | รหัสตอบรับจากผู้ให้บริการ |
2 | Failed — ระบบส่งไม่สำเร็จ | VALIDATION_ERROR, SEND_ERROR |
3 | Delivered — ส่งถึงเครื่องผู้รับแล้ว | รหัสจากผู้ให้บริการ |
4 | Rejected — บัญชีถูกระงับ | 91 |
5 | Rejected — เบอร์อยู่ใน Blacklist / ผู้รับขอยกเลิกรับ / ไม่มี consent | 92, SUPPRESSED, NO_CONSENT |
6 | Rejected — เกินโควตาการส่งต่อวันของบัญชี | 512 |
7 | Rejected — ชื่อผู้ส่งไม่ได้รับอนุญาต | 101 |
9 | Failed — ข้อความว่าง หรือผู้ให้บริการแจ้งว่าส่งไม่ถึงเครื่อง | 107 หรือรหัสจากผู้ให้บริการ |
TIP
ตัวอย่าง Request
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
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
}Error ที่อาจเจอ
ดูภาพรวมที่ รหัสข้อผิดพลาด
| HTTP | Response | สาเหตุ |
|---|---|---|
| 401 | {"error":{"statusCode":"401","description":"Invalid account","message":"UNAUTHORIZED"}} | ไม่พบบัญชีจากข้อมูลยืนยันตัวตน |
| 429 | {"error":{"statusCode":"429","description":"rate limit exceeded: max 50 requests per second per account","message":"TOO_MANY_REQUESTS"}} | เรียกถี่เกินกำหนด — รอตาม header Retry-After |
| 500 | {"error":{"statusCode":"500","description":"Failed to query SMS logs","message":"INTERNAL_ERROR"}} | ระบบค้นข้อมูลไม่สำเร็จชั่วคราว |
