# ดูจำนวนการตรวจตามช่วงเวลา

Source: https://checkslip.com/docs/count-slip-checks

GET `https://api.checkslip.com/api/slips/counts`

ใช้ API key

แสดงจำนวนการตรวจของบัญชีนี้ต่อช่วงเวลา แยกตาม outcome สำหรับวาดกราฟ · นับตามเวลาที่ส่งตรวจ (checked_at) เหมือนตารางประวัติการตรวจ ส่วนยอดการใช้เครดิตนับตามเวลาที่คิดเครดิตเสร็จ ตัวเลขสองหน้าจึงไม่เท่ากันเสมอ · bucket เลือกได้ MINUTE, FIVE_MINUTE, FIFTEEN_MINUTE, HOUR, THREE_HOUR, SIX_HOUR, TWELVE_HOUR หรือ DAY · ได้ไม่เกิน 1,440 จุดต่อครั้ง ถ้าช่วงเวลากว้างเกินกว่า bucket จะรองรับ ระบบตอบ 400 · กรองได้แค่เวลากับ outcome ตัวกรองอื่นที่ส่งมาจะอยู่ใน filters_ignored · ตัวเลขตามหลังรายการจริงได้ราว 2 นาที ดูจาก as_of · ไม่หักเครดิต · ใช้ API key ที่มีสิทธิ์ slip:read

## Parameters

| ฟิลด์ | ส่งทาง | ชนิด | จำเป็น |
| --- | --- | --- | --- |
| `from` | query | `string (date-time)` | ใช่ |
| `to` | query | `string (date-time)` | ใช่ |
| `bucket` | query | `MINUTE \| FIVE_MINUTE \| FIFTEEN_MINUTE \| HOUR \| THREE_HOUR \| SIX_HOUR \| TWELVE_HOUR \| DAY` | ใช่ |
| `outcome` | query | `FOUND \| NOT_FOUND \| DUPLICATE \| PENDING \| UNAVAILABLE \| INVALID_QR \| INVALID_FILE \| QR_TAMPERED \| TOO_OLD[]` | ไม่ |
| `outcome_not` | query | `FOUND \| NOT_FOUND \| DUPLICATE \| PENDING \| UNAVAILABLE \| INVALID_QR \| INVALID_FILE \| QR_TAMPERED \| TOO_OLD[]` | ไม่ |
| `q` | query | `string` | ไม่ |
| `trans_ref` | query | `string` | ไม่ |
| `sender_bank` | query | `string` | ไม่ |
| `api_key` | query | `string` | ไม่ |
| `after` | query | `string` | ไม่ |
| `charged` | query | `string[]` | ไม่ |
| `free_reason` | query | `string[]` | ไม่ |

## Responses

### 200 `application/json`

| ฟิลด์ | ชนิด | จำเป็น |
| --- | --- | --- |
| `bucket` | `MINUTE \| FIVE_MINUTE \| FIFTEEN_MINUTE \| HOUR \| THREE_HOUR \| SIX_HOUR \| TWELVE_HOUR \| DAY` | ใช่ |
| `as_of` | `string (date-time)` | ใช่ |
| `filters_applied` | `from \| to \| outcome \| outcome_not[]` | ใช่ |
| `filters_ignored` | `q \| trans_ref \| sender_bank \| api_key \| after \| charged \| free_reason[]` | ใช่ |
| `series` | `object[]` | ใช่ |
| `series[].start` | `string (date-time)` | ใช่ |
| `series[].counts` | `object` | ใช่ |

### Error ที่อาจได้

400 401 403 429

error ในรูป Problem Details ดูรหัสทั้งหมดที่ [รหัสข้อผิดพลาด](https://checkslip.com/docs/errors)

**cURL**

```bash
curl "https://api.checkslip.com/api/slips/counts?from=2026-11-05T09%3A30%3A00%2B07%3A00&to=2026-11-05T09%3A30%3A00%2B07%3A00&bucket=MINUTE" \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY"
```

**Node.js**

```javascript
const res = await fetch("https://api.checkslip.com/api/slips/counts?from=2026-11-05T09%3A30%3A00%2B07%3A00&to=2026-11-05T09%3A30%3A00%2B07%3A00&bucket=MINUTE", {
  headers: {
    Authorization: `Bearer ${process.env.CHECKSLIP_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os

import requests

res = requests.get(
    "https://api.checkslip.com/api/slips/counts",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
    },
    params={
        "from": "2026-11-05T09:30:00+07:00",
        "to": "2026-11-05T09:30:00+07:00",
        "bucket": "MINUTE",
    },
)
data = res.json()
```

```json
{
  "bucket": "MINUTE",
  "as_of": "2026-11-05T09:30:00+07:00",
  "filters_applied": [
    "from"
  ],
  "filters_ignored": [
    "q"
  ],
  "series": [
    {
      "start": "2026-11-05T09:30:00+07:00",
      "counts": {}
    }
  ]
}
```