// schemas / BANK_TRANSACTION
입출금내역
bank.transactions.cb.v1
연결된 뱅킹 프로바이더의 모든 계좌 입출금내역
요청 파라미터
날짜 범위 필수 — 최대 365일, chunk 90일 단위로 자동 분할.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| dateRangeStart | date | 시작일 조회 시작일 (YYYY-MM-DD) | 예 |
| dateRangeEnd | date | 종료일 조회 종료일 (YYYY-MM-DD) | 예 |
| accountNumber | string | 계좌번호 필터 특정 계좌만 조회. 생략 시 전 계좌 스캔 | 아니오 |
| currencyCode | string | 통화 코드 필터 (선택) 특정 통화의 거래만 조회. ISO 4217 3자 (KRW/USD/JPY/CNY 등). 미지정 시 모든 통화의 거래를 통합 조회 | 아니오 |
응답 필드
data-jobs/{id}/results 응답의 data[] 각 항목.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| transactionAt | datetime | 거래 시각 ISO 8601 with offset (예: 2026-04-21T14:30:00+09:00) | 예 |
| accountNumber | string | 계좌번호 하이픈/공백 없는 연속 숫자 | 예 |
| accountNumberFormatted | string | 표시용 계좌번호 금융기관이 UI 에 보여주는 하이픈 포함 포맷 (예: `140-014-167889`). 계좌 목록 조회 시점에 확인된 값을 그대로 사용하며, 금융기관 미제공이면 null | 아니오 |
| accountType | string | 계좌 유형 입출금내역 지원 유형 (CHECKING / FOREIGN / FUND / LOAN) enum: CHECKING, INSTALLMENT_SAVINGS, TRUST, FUND, FOREIGN, LOAN, INSURANCE, PENSION | 예 |
| currencyCode | string | 통화 코드 ISO 4217 3자 (KRW, USD, ...). FUND/LOAN 은 KRW 고정 | 예 |
| amount | number | 거래 금액 해당 계좌 잔고 증감 기준 부호값. 입금/매수 +, 출금/매도/상환 - | 예 |
| description | string | 적요 거래 설명 (이체 상대방/가맹점명/상품명 등 은행이 제공). 비어있으면 null | 아니오 |
| balance | number | 거래 후 잔액 거래 직후 잔액. 일부 유형/기관은 미제공으로 null 가능 | 아니오 |