ดูยอดการใช้เครดิต

GEThttps://api.checkslip.com/api/usage

ใช้ API key

แสดงจำนวนครั้งที่ตรวจ จำนวนครั้งที่หักเครดิต และจำนวนครั้งที่ไม่หัก แยกเป็นช่องตามเหตุผล เช่น free_not_found หรือ free_too_old เป็นรายวันหรือรายเดือนตามเวลาประเทศไทย (interval=DAY หรือ MONTH) วันหรือเดือนที่ไม่มีการตรวจจะแสดงเป็นศูนย์ ไม่ถูกข้าม รายวันดูได้ครั้งละไม่เกิน 92 วัน รายเดือนไม่เกิน 24 เดือน ยอดนับตามวันที่คิดเครดิตเสร็จ (settled_at) ไม่ใช่วันที่ส่งตรวจ ปกติห่างกันไม่กี่วินาที การตรวจใกล้เที่ยงคืนจึงอาจไปนับวันถัดไป ยอดช้ากว่าเวลาจริงประมาณ 1 นาที (ดูเวลาของยอดที่ as_of) ถ้าต้องการผลทีละรายการที่ตรงทันทีให้ดูประวัติการตรวจ (ต้องมีสิทธิ์ slip:read) เรียกดูยอดไม่หักเครดิต ใช้ API key ที่มีสิทธิ์ usage:read

Parameters

ฟิลด์	ส่งทาง	ชนิด	จำเป็น
`X-Request-Id`	header	`string`	ไม่
`interval`	query	`DAY \| MONTH`	ไม่
`from`	query	`string (date)`	ใช่
`to`	query	`string (date)`	ใช่

Responses

200 `application/json`

ฟิลด์	ชนิด	จำเป็น
`interval`	`DAY \| MONTH`	ใช่
`as_of`	`string (date-time)`	ใช่
`from`	`string (date)`	ใช่
`to`	`string (date)`	ใช่
`timezone`	`string = Asia/Bangkok`	ใช่
`buckets`	`object[]`	ใช่
`totals`	`UsageCounts`	ใช่
`totals.checks`	`integer`	ใช่
`totals.charged`	`integer`	ใช่
`totals.free_not_found`	`integer`	ใช่
`totals.free_duplicate`	`integer`	ใช่
`totals.free_unavailable`	`integer`	ใช่
`totals.free_invalid_qr`	`integer`	ใช่
`totals.free_invalid_file`	`integer`	ใช่
`totals.free_qr_tampered`	`integer`	ใช่
`totals.free_too_old`	`integer`	ใช่
`totals.free_system_error`	`integer`	ใช่
`totals.free_other`	`integer`	ใช่

Error ที่อาจได้

400401default

error ในรูป Problem Details ดูรหัสทั้งหมดที่ รหัสข้อผิดพลาด

curl "https://api.checkslip.com/api/usage?from=2026-11-05&to=2026-11-05" \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY"

const res = await fetch("https://api.checkslip.com/api/usage?from=2026-11-05&to=2026-11-05", {
  headers: {
    Authorization: `Bearer ${process.env.CHECKSLIP_API_KEY}`,
  },
});
const data = await res.json();

import os

import requests

res = requests.get(
    "https://api.checkslip.com/api/usage",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
    },
    params={
        "from": "2026-11-05",
        "to": "2026-11-05",
    },
)
data = res.json()

ตัวอย่าง response

{
  "interval": "DAY",
  "as_of": "2026-11-05T09:30:00+07:00",
  "from": "2026-11-05",
  "to": "2026-11-05",
  "timezone": "Asia/Bangkok",
  "buckets": [
    {
      "start": "2026-11-05",
      "checks": 1,
      "charged": 1,
      "free_not_found": 1,
      "free_duplicate": 1,
      "free_unavailable": 1,
      "free_invalid_qr": 1,
      "free_invalid_file": 1,
      "free_qr_tampered": 1,
      "free_too_old": 1,
      "free_system_error": 1,
      "free_other": 1
    }
  ],
  "totals": {
    "checks": 1,
    "charged": 1,
    "free_not_found": 1,
    "free_duplicate": 1,
    "free_unavailable": 1,
    "free_invalid_qr": 1,
    "free_invalid_file": 1,
    "free_qr_tampered": 1,
    "free_too_old": 1,
    "free_system_error": 1,
    "free_other": 1
  }
}

Parameters#

Responses#

200 application/json#

Error ที่อาจได้#

Parameters

Responses

200 `application/json`

Error ที่อาจได้