Developer Portal

API 명 (URI)	/api/v1/provide/list
Method	POST
Content-Type	application/json; charset=UTF-8

계좌의 거래내역을 조회합니다.(금융거래정보제공 동의 계좌만 가능)

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	Authorization	인증 ("Bearer"+token)	Y	Field	String	400
Body	opapiTlgrTxDt	거래일자	Y	Field	String	8
Body	opapiTlgrTxTms	거래시간	Y	Field	String	6
Body	opapiAlncInstId	제휴기관식별자	Y	Field	String	10
Body	opapiTlgrTxUnqNbr	거래일련번호	Y	Field	String	12
Body	opapiCustSeqNbr	고객일련번호	Y	Field	Number	20
Body	opapiAcctNbr	계좌번호	Y	Field	String	100
Body	opapiDpstWhdrwlDscd	입출구분코드	Y	Field	String	1
Body	opapiInqryBaseCd	조회기준코드	Y	Field	String	1
Body	opapiInqryStartDt	조회시작일자	Y	Field	String	8
Body	opapiInqryEndDt	조회종료일자	Y	Field	String	8
Body	opapiInqryStartTms	조회시작시각		Field	String	6
Body	opapiInqryEndTms	조회종료시각		Field	String	6
Body	opapiLnpSqnc	정렬순서	Y	Field	String	1
Body	opapiNxtKey	직전조회추적정보		Field	String	18

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	Authorization	인증 ("Bearer"+token)	Y	Field	String	400
Body	opapiTlgrTxDt	거래일자	Y	Field	String	8
Body	opapiTlgrTxTms	거래시간	Y	Field	String	6
Body	opapiAlncInstId	제휴기관식별자	Y	Field	String	10
Body	opapiTlgrTxUnqNbr	거래일련번호	Y	Field	String	12
Body	opapiCustSeqNbr	고객일련번호	Y	Field	Number	20
Body	opapiAcctNbr	계좌번호	Y	Field	String	100
Body	opapiDpstWhdrwlDscd	입출구분코드	Y	Field	String	1
Body	opapiInqryBaseCd	조회기준코드	Y	Field	String	1
Body	opapiInqryStartDt	조회시작일자	Y	Field	String	8
Body	opapiInqryEndDt	조회종료일자	Y	Field	String	8
Body	opapiInqryStartTms	조회시작시각		Field	String	6
Body	opapiInqryEndTms	조회종료시각		Field	String	6
Body	opapiLnpSqnc	정렬순서	Y	Field	String	1
Body	opapiNxtKey	직전조회추적정보		Field	String	18

Body

{ "opapiTlgrTxDt": "20241213", "opapiTlgrTxTms": "132635", "opapiAlncInstId": "1", "opapiTlgrTxUnqNbr": "000002000022", "opapiCustSeqNbr": 3, "opapiAcctNbr": "b908f8811f54c822bbd7f7087b91058c", "opapiDpstWhdrwlDscd": "A", "opapiInqryBaseCd": "D", "opapiInqryStartDt": "20231001", "opapiInqryEndDt": "20241130", "opapiInqryStartTms": "", "opapiInqryEndTms": "", "opapiLnpSqnc": "D", "opapiNxtKey": "" }

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	opapiTxDt	거래일자	Y	Field	String	8
Body	opapiTxTms	거래시간	Y	Field	String	6
Body	opapiAlncInstId	제휴기관식별자	Y	Field	String	10
Body	opapiTlgrTxUnqNbr	거래일련번호	Y	Field	String	12
Body	opapiCustSeqNbr	고객일련번호	N	Field	Number	20
Body	opapiRspnsCd	응답코드	Y	Field	String	4
Body	opapiRspnsMsg	응답메시지	N	Field	String	100
Body	opapiAcctNbr	계좌번호	Y	Field	Number	100
Body	opapiCurrentBal	현재잔액	Y	Field	BigDecimal	18,2
Body	opapiNxtExistYn	다음존재여부	Y	Field	String	1
Body	opapiNxtKey	직전조회추적정보		Field	String	18
Body	opapiListCnt	리스트건수	Y	Field	Number	5
Body	opapiList	리스트		List
Body	▫ opapiTxDt	거래일자	Y	Field	String	8
Body	▫ opapiTxTms	거래시간	Y	Field	String	6
Body	▫ opapiDpstWhdrwlDmrctnNm	입출금구분명	Y	Field	String	8
Body	▫ opapiTxNm	적요구분코드명	Y	Field	String	100
Body	▫ opapiTxRmk	적요-메모	Y	Field	String	100
Body	▫ opapiTxAmt	거래금액	Y	Field	BigDecimal	18,2
Body	▫ opapiTxAfBal	거래후잔액	Y	Field	BigDecimal	18,2

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	opapiTxDt	거래일자	Y	Field	String	8
Body	opapiTxTms	거래시간	Y	Field	String	6
Body	opapiAlncInstId	제휴기관식별자	Y	Field	String	10
Body	opapiTlgrTxUnqNbr	거래일련번호	Y	Field	String	12
Body	opapiCustSeqNbr	고객일련번호	N	Field	Number	20
Body	opapiRspnsCd	응답코드	Y	Field	String	4
Body	opapiRspnsMsg	응답메시지	N	Field	String	100
Body	opapiAcctNbr	계좌번호	Y	Field	Number	100
Body	opapiCurrentBal	현재잔액	Y	Field	BigDecimal	18,2
Body	opapiNxtExistYn	다음존재여부	Y	Field	String	1
Body	opapiNxtKey	직전조회추적정보		Field	String	18
Body	opapiListCnt	리스트건수	Y	Field	Number	5
Body	opapiList	리스트		List
Body	▫ opapiTxDt	거래일자	Y	Field	String	8
Body	▫ opapiTxTms	거래시간	Y	Field	String	6
Body	▫ opapiDpstWhdrwlDmrctnNm	입출금구분명	Y	Field	String	8
Body	▫ opapiTxNm	적요구분코드명	Y	Field	String	100
Body	▫ opapiTxRmk	적요-메모	Y	Field	String	100
Body	▫ opapiTxAmt	거래금액	Y	Field	BigDecimal	18,2
Body	▫ opapiTxAfBal	거래후잔액	Y	Field	BigDecimal	18,2

Body

{ "opapiTxDt": "20241213", "opapiTxTms": "132635", "opapiAlncInstId": "1", "opapiTlgrTxUnqNbr": "000002000022", "opapiCustSeqNbr": 3, "opapiRspnsCd": "0000", "opapiRspnsMsg": "정상", "opapiAcctNbr": "b908f8811f54c822bbd7f7087b91058c", "opapiCurrentBal": 1042148726, "opapiNxtExistYn": "Y", "opapiNxtKey": "202303313", "opapiListCnt": 6, "opapiList": [ { "opapiTxDt": "20241007", "opapiTxTms": "112933", "opapiDpstWhdrwlDmrctnNm": "입금", "opapiTxNm": "이선국", "opapiTxRmk": "대체", "opapiTxAmt": 4400000, "opapiTxAfBal": 992148726 }, { "opapiTxDt": "20241007", "opapiTxTms": "111124", "opapiDpstWhdrwlDmrctnNm": "입금", "opapiTxNm": "고건무", "opapiTxRmk": "대체", "opapiTxAmt": 20000000, "opapiTxAfBal": 992108726 }, { "opapiTxDt": "20231123", "opapiTxTms": "160732", "opapiDpstWhdrwlDmrctnNm": "입금", "opapiTxNm": "출석체크 이벤트 당첨금", "opapiTxRmk": "케이뱅크이벤트 ", "opapiTxAmt": 3, "opapiTxAfBal": 991898726 }, { "opapiTxDt": "20231122", "opapiTxTms": "091453", "opapiDpstWhdrwlDmrctnNm": "입금", "opapiTxNm": "출석체크 이벤트 당첨금", "opapiTxRmk": "케이뱅크이벤트", "opapiTxAmt": 2, "opapiTxAfBal": 991898723 }, { "opapiTxDt": "20231026", "opapiTxTms": "153932", "opapiDpstWhdrwlDmrctnNm": "입금", "opapiTxNm": "출석체크 이벤트 당첨금", "opapiTxRmk": "케이뱅크이벤트", "opapiTxAmt": 1, "opapiTxAfBal": 991898721 } ] }

kbank