오픈API

외화 예금 계좌 거래내역 조회 v1.0.0

외화 예금 계좌 거래내역 조회 v1.0.0

API개요

API개요(API 명, API 설명, URL, HTTP Method, OAuth 2.0, 제3자 정보제공 동의) 표
API 명 외화 예금 계좌 거래내역 조회
API 설명 외화 예금 계좌 거래내역 조회
URL /ibk/biz/bizFrmnAcntTrhsInq
HTTP Method POST
OAuth 2.0 Y
제3자 정보제공 동의 비대상
이용금액 별도협의

Request Header

항목명 필드명 데이터타입 길이 Scale 필수여부 설명
오픈API사용자일련번호oapiusersrnNumber100

클라이언트ID

X-IBK-Client-Id

String

32

0

클라이언트Sceret

X-IBK-Client-Secret

String

320

Authorization

Authorization

String

40000

Request Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1오픈API클라이언트IDoapiClntIdString500
1오픈API정보제공대체번호oapiInofrAltrNoString200
1조회시작년월일insgYmdString80
1조회종료년월일inqFnshYmdString80
1조회구분코드inqDcdString10
1출력거래유형구분코드otptTrtpDcdString10
1거래년월일_NEXTKEYtrnListNextkeyTrnYmdString80
1종료년월일_NEXTKEYtrnListNextkeyFnshYmdString80
1수신거래일련번호_NEXTKEYtrnListNextkeyDepTrnSrnNumber70

Request Sample

{
  "oapiInofrAltrNo" : "sample_oapiInofrAltrNo",
  "oapiInofrTgtNo" : "sample_oapiInofrTgtNo",
  "arrTobNo" : 0.0,
  "dpsrNm" : "sample_dpsrNm",
  "pdm" : "sample_pdm",
  "ldgrBal" : 0.0,
  "pymtAblAmt" : 0.0,
  "trnListNextkeyTrnYmd" : "sample_trnListNextkeyTrnYmd",
  "trnListNextkeyFnshYmd" : "sample_trnListNextkeyFnshYmd",
  "trnListNextkeyDepTrnSrn" : 0.0,
  "trnListRowcount" : 0.0,
  "trnList" : [ {
    "trnYmd" : "sample_trnYmd",
    "fnshYmd" : "sample_fnshYmd",
    "depTrnSrn" : 0.0,
    "inptHms" : "sample_inptHms",
    "trnAmt" : 0.0,
    "aftrBal" : 0.0,
    "trnDsncNm" : "sample_trnDsncNm",
    "dwmDcd" : "sample_dwmDcd",
    "rmtnBncd" : "sample_rmtnBncd",
    "trnSmr" : "sample_trnSmr",
    "crcd" : "sample_crcd",
    "bnprTrnCtcdVlNm" : "sample_bnprTrnCtcdVlNm",
    "cnacDpsrNm" : "sample_cnacDpsrNm"
  } ]
}

Response Header

Response Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1오픈API정보제공대체번호oapiInofrAltrNoString200
1오픈API정보제공대상번호oapiInofrTgtNoString200
1계약회차번호arrTobNoNumber100
1예금주명dpsrNmString500
1상품명pdmString1000
1원장잔액ldgrBalNumber193
1지불가능금액pymtAblAmtNumber193
1거래년월일_NEXTKEYtrnListNextkeyTrnYmdString80
1종료년월일_NEXTKEYtrnListNextkeyFnshYmdString80
1수신거래일련번호_NEXTKEYtrnListNextkeyDepTrnSrnNumber70
1거래내역카운트trnListRowcountNumber50
1거래내역trnList

Array

00
2거래년월일trnYmdString80
2종료년월일fnshYmdString80
2수신거래일련번호depTrnSrnNumber70
2입력시각inptHmsString60
2거래금액trnAmtNumber193
2거래후잔액aftrBalNumber193
2거래구분명trnDsncNmString300
2입출금구분코드dwmDcdString20
2송금은행코드rmtnBncdString30
2거래적요trnSmrString1000
2통화코드crcdString30
2통장인자거래내용코드값명bnprTrnCtcdVlNmString1000
2상대계좌예금주명cnacDpsrNmString500

Response Sample

{
  "oapiInofrAltrNo" : "sample_oapiInofrAltrNo",
  "oapiInofrTgtNo" : "sample_oapiInofrTgtNo",
  "arrTobNo" : 0.0,
  "dpsrNm" : "sample_dpsrNm",
  "pdm" : "sample_pdm",
  "ldgrBal" : 0.0,
  "pymtAblAmt" : 0.0,
  "trnListNextkeyTrnYmd" : "sample_trnListNextkeyTrnYmd",
  "trnListNextkeyFnshYmd" : "sample_trnListNextkeyFnshYmd",
  "trnListNextkeyDepTrnSrn" : 0.0,
  "trnListRowcount" : 0.0,
  "trnList" : [ {
    "trnYmd" : "sample_trnYmd",
    "fnshYmd" : "sample_fnshYmd",
    "depTrnSrn" : 0.0,
    "inptHms" : "sample_inptHms",
    "trnAmt" : 0.0,
    "aftrBal" : 0.0,
    "trnDsncNm" : "sample_trnDsncNm",
    "dwmDcd" : "sample_dwmDcd",
    "rmtnBncd" : "sample_rmtnBncd",
    "trnSmr" : "sample_trnSmr",
    "crcd" : "sample_crcd",
    "bnprTrnCtcdVlNm" : "sample_bnprTrnCtcdVlNm",
    "cnacDpsrNm" : "sample_cnacDpsrNm"
  } ]
}

성공/실패 Case