Skip to content

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

Content Type ​

ไม่มี body — ส่งเงื่อนไขเป็น query string

Parameter Description ​

ทุกพารามิเตอร์ไม่บังคับ ถ้าไม่ส่งเลยจะได้ทุกรายการของบัญชี (หน้าแรก 20 รายการ)

PropertyTypeRequiredDescription
messageIdstringOptionalค้นด้วยรหัสข้อความของระบบ (smsId ในผลลัพธ์) — ตรงกับ details[].messageId จาก ส่ง SMS เฉพาะกรณีที่คุณ ไม่ได้ กำหนด messageId เอง
mobilestringOptionalเบอร์ปลายทาง ต้องตรงทุกตัวในรูปแบบ 66XXXXXXXXX เช่น 66812345678 (ระบบไม่แปลงรูปแบบให้)
bulkIdstringOptionalbulkId จาก ส่ง SMS (สำหรับ OTP คือ otpId)
dateFromstringOptionalวันเวลาเริ่ม (นับจากเวลาที่บันทึกรายการ) รูปแบบ RFC3339 เช่น 2026-11-01T00:00:00+07:00 หรือ YYYY-MM-DD (= 00:00:00 UTC ของวันนั้น)
dateTostringOptionalวันเวลาสิ้นสุด รูปแบบ RFC3339 หรือ YYYY-MM-DD (= สิ้นวันนั้นตามเวลา UTC)
pageintegerOptionalหน้าที่ต้องการ เริ่มที่ 1 (ค่าเริ่มต้น 1)
pageSizeintegerOptionalจำนวนต่อหน้า 1–100 (ค่าเริ่มต้น 20; ค่านอกช่วงจะใช้ 20)

รูปแบบวันที่

ถ้า dateFrom / dateTo ผิดรูปแบบ ระบบ ไม่แจ้ง error แต่จะไม่ใช้เงื่อนไขนั้น — ส่งแบบ RFC3339 พร้อม +07:00 เพื่อให้ได้ช่วงเวลาไทยที่ถูกต้อง

Response Description ​

PropertyTypeDescription
statusnumber200
dataarray of Logรายการในหน้านี้ (null เมื่อไม่พบข้อมูล)
totalRecordnumberจำนวนรายการทั้งหมดที่ตรงเงื่อนไข
pagenumberหน้าปัจจุบัน
pageSizenumberจำนวนต่อหน้า

Log ​

PropertyTypeDescription
smsIdstringรหัสข้อความของระบบ
accountIdnumberรหัสบัญชี
userIdnumberรหัสผู้ใช้ที่ส่ง
bulkIdstringรหัสกลุ่มการส่ง (ไม่มีฟิลด์นี้ถ้าไม่มีค่า)
campaignIdstringรหัสแคมเปญ (มีเฉพาะบางรายการ)
fromstringชื่อผู้ส่ง
tostringเบอร์ปลายทาง 66XXXXXXXXX
textstringข้อความ (ข้อความ OTP จะถูกปิดรหัส)
statusnumberสถานะ ดู ตารางสถานะ
statusCodestringรหัสสถานะละเอียด (จากระบบหรือผู้ให้บริการเครือข่าย)
statusDescriptionstringคำอธิบายผลจากผู้ให้บริการเครือข่าย (มีเมื่อได้รับ Delivery Report)
smsTypenumberประเภทข้อความ
creditnumberเครดิตที่ใช้ (0 สำหรับรายการที่ถูกปฏิเสธ)
gatewayobjectข้อมูลเส้นทางส่ง: name (ชื่อเส้นทาง), ackId (รหัสอ้างอิงจากผู้ให้บริการ), operatorCode (รหัสผลจากผู้ให้บริการ)
notifyUrlstringURL สำหรับ Delivery Report (ถ้ากำหนดไว้)
sentAtstringเวลาที่ส่งไปยังผู้ให้บริการเครือข่าย (ISO 8601)
deliveredAtstringเวลาที่ส่งถึงเครื่องผู้รับ (มีเมื่อ status = 3)
createdAtstringเวลาที่บันทึกรายการ (ISO 8601)
updatedAtstringเวลาที่อัปเดตล่าสุด (ISO 8601)

สถานะ ​

statusความหมายstatusCode ที่พบ
1Sent — ส่งถึงผู้ให้บริการเครือข่ายแล้ว รอผลการส่งถึงเครื่องรหัสตอบรับจากผู้ให้บริการ
2Failed — ระบบส่งไม่สำเร็จVALIDATION_ERROR, SEND_ERROR
3Delivered — ส่งถึงเครื่องผู้รับแล้วรหัสจากผู้ให้บริการ
4Rejected — บัญชีถูกระงับ91
5Rejected — เบอร์อยู่ใน Blacklist / ผู้รับขอยกเลิกรับ / ไม่มี consent92, SUPPRESSED, NO_CONSENT
6Rejected — เกินโควตาการส่งต่อวันของบัญชี512
7Rejected — ชื่อผู้ส่งไม่ได้รับอนุญาต101
9Failed — ข้อความว่าง หรือผู้ให้บริการแจ้งว่าส่งไม่ถึงเครื่อง107 หรือรหัสจากผู้ให้บริการ

TIP

  • รายการจะปรากฏหลังระบบประมวลผลคิวแล้ว (ไม่ใช่ทันทีที่ ส่ง SMS ตอบกลับ)
  • เบอร์ที่ถูกปฏิเสธตั้งแต่ตอนเรียก ส่ง SMS (เช่น 402 เบอร์ไม่ถูกต้อง) จะไม่มีรายการใน log

ตัวอย่าง 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 ที่อาจเจอ ​

ดูภาพรวมที่ รหัสข้อผิดพลาด

HTTPResponseสาเหตุ
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"}}ระบบค้นข้อมูลไม่สำเร็จชั่วคราว