---
title: 현금영수증 목록 조회
description: GET /v1/cash-receipts 로 내 계정의 현금영수증 발급 내역을 페이지 단위로 조회해요.
sidebar:
  order: 2
  badge: GET
---

```http
GET /v1/cash-receipts
```

API 키 계정의 현금영수증을 최신순으로 조회해요. 상태, 종류, 식별번호, 발급 날짜로 거를 수 있어요.

## 쿼리 파라미터

| 파라미터 | 타입 | 필수 | 설명 |
| --- | --- | --- | --- |
| `offset` | integer | 예 | 건너뛸 항목 수예요. 0 이상이에요. |
| `limit` | integer | 예 | 가져올 항목 수예요. 1~100이에요. |
| `search` | string | | 현금영수증 ID, 관련 주문 ID, 사업자등록번호가 같거나, 식별번호에 검색어가 들어간 현금영수증을 찾아요. 사업자등록번호와 식별번호는 하이픈이 있어도 찾아요. |
| `status` | string | | `PENDING`, `ISSUED`, `FAILED`, `REVOKED` 중 하나로 걸러요. |
| `type` | string | | `PERSONAL` 또는 `CORPORATE`로 걸러요. |
| `identifier` | string | | 식별번호(휴대폰 번호나 사업자등록번호)가 같은 현금영수증만 조회해요. |
| `corpNum` | string | | 발급한 사업자의 사업자등록번호로 걸러요. |
| `dateAfter` | string | | 이 날짜(KST) 이후에 발급을 요청한 현금영수증만 조회해요. 그날도 포함해요. `YYYY-MM-DD` |
| `dateBefore` | string | | 이 날짜(KST) 이전에 발급을 요청한 현금영수증만 조회해요. 그날도 포함해요. `YYYY-MM-DD` |

## 요청 예시

```bash cURL
curl "https://api.paysync.kr/v1/cash-receipts?offset=0&limit=20&status=ISSUED" \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"
```

```js Node.js
const params = new URLSearchParams({ offset: "0", limit: "20", status: "ISSUED" });
const res = await fetch(`https://api.paysync.kr/v1/cash-receipts?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { totalItems, data } = await res.json();
```

```python Python
import os
import requests

res = requests.get(
    "https://api.paysync.kr/v1/cash-receipts",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
    params={"offset": 0, "limit": 20, "status": "ISSUED"},
)
print(res.json())
```

## 응답

`data`는 [현금영수증 객체](/api-reference/cash-receipts/get#현금영수증-객체) 배열이고, `totalItems`는 조건에 맞는 전체 수예요.

```json 200 OK
{
  "code": "OK",
  "totalItems": 1,
  "data": [
    {
      "id": "crt_a1b2c3d4e5f6g7h8i9j0k1l2",
      "status": "ISSUED",
      "issuerId": "acc_x9y8z7w6v5u4t3s2r1q0p9o8",
      "corpNum": "1234567890",
      "type": "PERSONAL",
      "identifier": "01012345678",
      "amount": 50000,
      "relatedInvoiceId": "ivc_n0o1p2q3r4s5t6u7v8w9x0y1",
      "ntsConfirmNum": "TB0000123",
      "ntsResultCode": "0000",
      "issuedAt": "2026-04-28T03:20:13.000Z",
      "revokedAt": null,
      "deletedAt": null
    }
  ]
}
```

## 오류

| HTTP | `code` | 발생 조건 |
| --- | --- | --- |
| 401 | `NOT_AUTHORIZED` | API 키가 없거나 올바르지 않아요. |
| 403 | `LIMIT_EXCEEDS_MAXIMUM` | `limit`이 100을 넘어요. |
| 422 | `INVALID_OFFSET` | `offset`이 0보다 작아요. |
| 422 | `INVALID_LIMIT` | `limit`이 0 이하예요. |
| 422 | `INVALID_DATE_RANGE_FORMAT` | `dateAfter`나 `dateBefore`가 `YYYY-MM-DD` 형식이 아니에요. |