// schemas / BANK_ACCOUNT
계좌 목록
bank.accounts.cb.v1
연결된 뱅킹 프로바이더의 모든 계좌 목록
요청 파라미터
| 필드 | 타입 | 표시명 | 필수 |
|---|
응답 필드
data-jobs/{id}/results 응답의 data[] 각 항목.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| accountNumber | string | 계좌번호 하이픈/공백 없는 연속 숫자 | 예 |
| accountType | string | 계좌 유형 계좌 성격 구분 (요구불/펀드/대출 등) enum: CHECKING, INSTALLMENT_SAVINGS, TRUST, FUND, FOREIGN, LOAN, INSURANCE, PENSION | 예 |
| currencyCode | string | 통화 코드 ISO 4217 3자 (KRW, USD, ...) | 예 |
| displayName | string | 표시명 사용자가 인터넷뱅킹에 지정한 애칭. 없으면 null | 아니오 |
| accountNumberFormatted | string | 표시용 계좌번호 금융기관이 UI 에 보여주는 하이픈 포함 포맷 (예: `140-014-167889`). 평생계좌 등 부가 정보가 괄호로 이어질 수 있다 | 아니오 |
| productName | string | 상품명 금융기관 상품명 (예: KB Star 정기예금) | 아니오 |
| balance | number | 현재 잔액 해당 계좌의 통화 기준 현재 잔액 | 아니오 |
| availableBalance | number | 출금 가능 금액 즉시 이체·출금 가능한 가용 잔액 | 아니오 |