오픈API

여신계좌 거래내역 조회 v1.0.0

여신계좌 거래내역 조회 v1.0.0

API개요

API개요(API 명, API 설명, URL, HTTP Method, OAuth 2.0, 제3자 정보제공 동의) 표
API 명 여신계좌 거래내역 조회
API 설명 개인/기업 사용자의 기간별 여신계좌 거래내역을 조회할 수 있습니다.
URL /ibk/biz/bizLnacTrhsInq
HTTP Method POST
OAuth 2.0 Y
제3자 정보제공 동의 비대상
이용금액 별도협의

Request Header

항목명 필드명 데이터타입 길이 Scale 필수여부 설명
이용기관 고객 사용자일련번호oapiusersrnNumber10-Y오픈API서비스의 정보주체(사용자)를 식별하기 위한 고유 일련번호

이용기관 Client ID

X-IBK-Client-Id

String

32

-Y

이용기관 Client Sceret

X-IBK-Client-Secret

String

32-Y

이용기관 고객 Access Token

Authorization

String

240-YAccess Token

Request Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1오픈API클라이언트IDoapiClntIdString50-Y
1

오픈API정보제공대상번호

oapiInofrTgtNo

String20-N

정보등록한 실제 여신 계좌번호

- 마스킹 미처리 대상 이용기관인 경우에는 필수

1계약회차번호

arrTobNo

Number10-N

미입력시 기본값 : 0

- 마스킹 미처리 대상 이용기관인 경우에는 필수

1

오픈API정보제공대체번호

oapiInofrAltrNo

String

20

-N

계좌 대체번호

- 마스킹 처리 대상 이용기관인 경우에는 필수

1조회시작년월일insgYmdString8-Y
1조회종료년월일inqFnshYmdString8-Y
1순차정렬여부turnLnpYnString1-Y

'N': 최근일로부터

'Y': 과거일로부터

1페이지조회건수pageInqNbiNumber10-N

페이징 건수

1여신거래일련번호_NEXTKEYtrnListNextkeyLbtxSrnNumber7-N

페이징 NEXTKEY

Request Sample

{
"oapiClntId" : "{Client ID}",
      "oapiInofrAltrNo": "0312300000994340",
      "insgYmd": "20240101",
      "inqFnshYmd": "20241231",
      "turnLnpYn": "Y",
      "pageInqNbi": 1,
      "trnListNextkeyLbtxSrn": 0
}

Response Header

LV항목명필드명데이터타입길이Scale필수여부설명

Response Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1계정과목약칭명tlacAbnmNmString50-Y
1대출약정금액lnagAmtNumber193Y
1오픈API정보제공대상번호oapiInofrTgtNoString20-Y
1계약회차번호arrTobNoNumber10-Y
1오픈API정보제공대체번호oapiInofrAltrNoString20-Y
1대출잔액loanBalNumber193Y
1자료계속여부datCntiYnString1-Y
1여신거래일련번호_NEXTKEYtrnListNextkeyLbtxSrnNumber7-N

페이징 NEXTKEY

1거래목록카운트trnListRowcountNumber5-Y
1거래목록trnList

Array

TRN_

LIST_

ROWCOUNT

-Y
2거래년월일trnYmdString8-Y
2거래구분명trnDsncNmString30-Y
2통화구분명crncDsncNmString100-Y
2거래금액trnAmtNumber193Y
2원금금액prncAmtNumber193Y
2이자금액intAmtNumber193Y
2대출잔액loanBalNumber193Y
2이율irtNumber127Y
2시작년월일sttgYmdString8-Y
2종료년월일fnshYmdString8-Y
2상태구분명stdsNmString30-Y
2여신거래일련번호lbtxSrnNumber7-Y

Response Sample

{
  "tlacAbnmNm": "중소기업시설자금대출",
  "lnagAmt": 3000000000.000,
  "oapiInofrTgtNo": "1231095***0093",
  "arrTobNo": 0,
  "oapiInofrAltrNo": "012300000994340",
  "loanBal": 3000000000.000,
  "datCntiYn": "Y",
  "trnListNextkeyLbtxSrn": 15,
  "trnListRowcount": 1,
  "trnList": [
    {
      "trnYmd": "20240124",
      "trnDsncNm": "이자수입",
      "crncDsncNm": "KRW",
      "trnAmt": 9476941.000,
      "prncAmt": 0.000,
      "intAmt": 9476941.000,
      "loanBal": 3000000000.000,
      "irt": 3.7270000,
      "sttgYmd": "20231224",
      "fnshYmd": "20240123",
      "stdsNm": "정상",
      "lbtxSrn": 12
    }
  ]
}

성공/실패 Case

{
  "tlacAbnmNm": "중소기업시설자금대출",
  "lnagAmt": 3000000000.000,
  "oapiInofrTgtNo": "1231095***0093",
  "arrTobNo": 0,
  "oapiInofrAltrNo": "012300000994340",
  "loanBal": 3000000000.000,
  "datCntiYn": "Y",
  "trnListNextkeyLbtxSrn": 15,
  "trnListRowcount": 1,
  "trnList": [
    {
      "trnYmd": "20240124",
      "trnDsncNm": "이자수입",
      "crncDsncNm": "KRW",
      "trnAmt": 9476941.000,
      "prncAmt": 0.000,
      "intAmt": 9476941.000,
      "loanBal": 3000000000.000,
      "irt": 3.7270000,
      "sttgYmd": "20231224",
      "fnshYmd": "20240123",
      "stdsNm": "정상",
      "lbtxSrn": 12
    }
  ]
}
{
					"msgCd" : "RECEAI000001",
					"mnmsgCntn" : "원인:동의내역 정보가 존재하지 않습니다. \r\n\r\n조치:입력값을 확인해 주시기 바랍니다."
					}