# ดูประวัติเครดิต

Source: https://checkslip.com/docs/list-ledger

GET `https://api.checkslip.com/api/billing/ledger`

ใช้ API key

แสดงทุกรายการที่ทำให้เครดิตเปลี่ยน ใหม่สุดก่อน ทั้งการซื้อ การตรวจที่หักเครดิต การตรวจที่ไม่หัก (พร้อมเหตุผลใน free_reason) และเครดิตที่หมดอายุ ใช้ตอบคำถามว่าเครดิตหายไปไหน ดูได้ครั้งละไม่เกิน 31 วัน ใช้ next_cursor เพื่อดูหน้าถัดไป ใช้ API key ที่มีสิทธิ์ credit:read หรือ billing:read

## Parameters

| ฟิลด์ | ส่งทาง | ชนิด | จำเป็น |
| --- | --- | --- | --- |
| `cursor` | query | `string` | ไม่ |
| `limit` | query | `integer` | ไม่ |
| `reason` | query | `string` | ไม่ |
| `from` | query | `string (date-time)` | ไม่ |
| `to` | query | `string (date-time)` | ไม่ |

## Responses

### 200 `application/json`

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

400 401 403 500

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

**cURL**

```bash
curl https://api.checkslip.com/api/billing/ledger \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY"
```

**Node.js**

```javascript
const res = await fetch("https://api.checkslip.com/api/billing/ledger", {
  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/billing/ledger",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
    },
)
data = res.json()
```

```json
{
  "next_cursor": "string",
  "items": [
    {
      "id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4",
      "delta": 1,
      "balance_after": 1,
      "expires_at_after": "2026-11-05T09:30:00+07:00",
      "reason": "TESTER_GRANT",
      "free_reason": "NOT_FOUND",
      "ref_type": "ORDER",
      "ref_id": "string",
      "created_at": "2026-11-05T09:30:00+07:00"
    }
  ]
}
```