---
title: 현금영수증 단건 조회
description: GET /v1/cash-receipts/{id} 로 현금영수증 하나의 발급 상태와 상세 정보를 조회해요.
sidebar:
  order: 3
  badge: GET
---

```http
GET /v1/cash-receipts/{id}
```

현금영수증 ID로 현금영수증 하나를 조회해요. 발급을 요청한 직후에는 `status`가 `PENDING`이에요. 국세청 처리에는 시간이 걸리니 짧은 간격으로 계속 조회하지 말고, 시간을 두고 확인하세요.

## 경로 파라미터

| 파라미터 | 타입 | 설명 |
| --- | --- | --- |
| `id` | string | 조회할 현금영수증 ID예요. `crt_`로 시작해요. |

## 요청 예시

```bash cURL
curl https://api.paysync.kr/v1/cash-receipts/crt_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"
```

```js Node.js
const res = await fetch(`https://api.paysync.kr/v1/cash-receipts/${cashReceiptId}`, {
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { code, data } = await res.json();
```

```python Python
import os
import requests

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

## 응답

```json 200 OK
{
  "code": "OK",
  "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
  }
}
```

### 현금영수증 객체

| 필드 | 타입 | 설명 |
| --- | --- | --- |
| `id` | string | 현금영수증 ID예요. `crt_`로 시작해요. |
| `status` | string | 발급 상태예요. 아래 표를 참고하세요. |
| `issuerId` | string | 발급한 페이싱크 계정 ID예요. |
| `corpNum` | string | 발급한 사업자의 사업자등록번호예요. |
| `type` | string | `PERSONAL`(소득공제용) 또는 `CORPORATE`(지출증빙용)예요. |
| `identifier` | string | 휴대폰 번호나 사업자등록번호예요. |
| `amount` | integer | 거래 금액(원)이에요. |
| `relatedInvoiceId` | string \| null | 주문 결제 완료로 자동 발급됐다면 그 주문 ID예요. |
| `ntsConfirmNum` | string | 국세청 승인번호예요. 발급을 요청할 때 받아요. |
| `ntsResultCode` | string \| null | 국세청 처리 결과 코드예요. 결과가 오기 전에는 `null`이에요. |
| `issuedAt` | string | 발급을 요청한 시각이에요. |
| `revokedAt` | string \| null | 발급을 취소한 시각이에요. |
| `deletedAt` | null | 조회할 수 있는 현금영수증에서는 `null`이에요. |

| `status` | 뜻 |
| --- | --- |
| `PENDING` | 국세청 처리를 기다리고 있어요. 이 상태에서만 [취소](/api-reference/cash-receipts/revoke)할 수 있어요. |
| `ISSUED` | 국세청 처리가 끝나 발급됐어요. |
| `FAILED` | 국세청 처리에 실패했어요. `ntsResultCode`로 이유를 확인하세요. |
| `REVOKED` | 발급을 취소했어요. |

## 오류

| HTTP | `code` | 발생 조건 |
| --- | --- | --- |
| 401 | `NOT_AUTHORIZED` | API 키가 없거나 올바르지 않아요. |
| 403 | `INSUFFICIENT_PERMISSIONS` | 다른 계정의 현금영수증이에요. |
| 404 | `CASH_RECEIPT_NOT_FOUND` | 현금영수증이 없어요. |