Developer Portal

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

아파트 담보대출(아담대) 대출금리 및 한도를 조회합니다.

요청 메시지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	Authorization	인증("Bearer"+token)	Y	Field	String	400
Body	dataCmn	공통부	Y	Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnCd	응답코드	Y	Field	String	4
Body	alcoLnAplctNbr	제휴사 대출신청번호	Y	Field	String	14
Body	mrtgLnFundTpCd	대출상품코드	Y	Field	String	12
Body	aplctnCustNm	고객명	Y	Field	String	152
Body	custSsNbr	주민등록번호	Y	Field	String	24
Body	aincmAmt	본인 연소득	Y	Field	Number	15
Body	spsIncmAdupYn	배우자소득합산여부	Y	Field	String	1
Body	spsAincmAmt	배우자연소득		Field	Number	15
Body	spsLbltAmt	배우자 부채금액		Field	Number	15
Body	custClphnNbr	고객휴대폰번호	Y	Field	String	44
Body	cmacDsCd	통신사코드	Y	Field	String	2
Body	ciIdNbr	CI	Y	Field	String	128
Body	alcoStplCnt	반복건수(동의항목 수)	Y	Field	Number	2
Body	alcoStplInfo	동의정보	Y	List
Body	▫ agrmntClseCd	동의항목코드	Y	Field	String	2
Body	▫ agrmDtHms	동의일시	Y	Field	String	14
Body	▫ agrmYn	동의여부	Y	Field	String	1
Body	prfSetngAmt	선순위설정금액		Field	Number	15
Body	otbkPrfYn	타행선순위여부		Field	String	1
Body	extrnlInstLnRpymntAmt	타기관대출상환금액(합계)		Field	Number	15
Body	fullRfnnYn	전액대환여부		Field	String	1
Body	leaseDpstRefdAmt	임대차보증금반환금액		Field	Number	15
Body	leaseScsnYn	임대차계약승계여부		Field	String	1
Body	prfLthrGrntYn	선순위임대차여부		Field	String	1
Body	hireCntDcd	보유주택코드	Y	Field	String	1
Body	cmppReowYn	서민실수요자여부		Field	String	1
Body	lifeFrstBuygYn	생애최초구입자금여부		Field	String	1
Body	kbMctxUnqCd	KB시세 고유코드	Y	Field	String	10
Body	kbMctxAreaCd	KB시세 평형코드	Y	Field	String	2
Body	bulRegiKeyNbr	관리건축물대장PK	Y	Field	String	33

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Header	Authorization	인증("Bearer"+token)	Y	Field	String	400
Body	dataCmn	공통부	Y	Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnCd	응답코드	Y	Field	String	4
Body	alcoLnAplctNbr	제휴사 대출신청번호	Y	Field	String	14
Body	mrtgLnFundTpCd	대출상품코드	Y	Field	String	12
Body	aplctnCustNm	고객명	Y	Field	String	152
Body	custSsNbr	주민등록번호	Y	Field	String	24
Body	aincmAmt	본인 연소득	Y	Field	Number	15
Body	spsIncmAdupYn	배우자소득합산여부	Y	Field	String	1
Body	spsAincmAmt	배우자연소득		Field	Number	15
Body	spsLbltAmt	배우자 부채금액		Field	Number	15
Body	custClphnNbr	고객휴대폰번호	Y	Field	String	44
Body	cmacDsCd	통신사코드	Y	Field	String	2
Body	ciIdNbr	CI	Y	Field	String	128
Body	alcoStplCnt	반복건수(동의항목 수)	Y	Field	Number	2
Body	alcoStplInfo	동의정보	Y	List
Body	▫ agrmntClseCd	동의항목코드	Y	Field	String	2
Body	▫ agrmDtHms	동의일시	Y	Field	String	14
Body	▫ agrmYn	동의여부	Y	Field	String	1
Body	prfSetngAmt	선순위설정금액		Field	Number	15
Body	otbkPrfYn	타행선순위여부		Field	String	1
Body	extrnlInstLnRpymntAmt	타기관대출상환금액(합계)		Field	Number	15
Body	fullRfnnYn	전액대환여부		Field	String	1
Body	leaseDpstRefdAmt	임대차보증금반환금액		Field	Number	15
Body	leaseScsnYn	임대차계약승계여부		Field	String	1
Body	prfLthrGrntYn	선순위임대차여부		Field	String	1
Body	hireCntDcd	보유주택코드	Y	Field	String	1
Body	cmppReowYn	서민실수요자여부		Field	String	1
Body	lifeFrstBuygYn	생애최초구입자금여부		Field	String	1
Body	kbMctxUnqCd	KB시세 고유코드	Y	Field	String	10
Body	kbMctxAreaCd	KB시세 평형코드	Y	Field	String	2
Body	bulRegiKeyNbr	관리건축물대장PK	Y	Field	String	33

요청 메시지 예제

Header

Content-Type: application/json

Body

{ "dataCmn":{ "fnclInstCd":"KBK", "alncInstCd":"JHC", "tlgrRspnsCd":"" }, "alcoLnAplctNbr":"NF0PJKYNYNX6II", "mrtgLnFundTpCd":"03", "aplctnCustNm":"YESERZjJnqIWvBFBHq0iDg==", "custSsNbr":"TpDRNoEZoWKQs4oZLtx\/vg==", "aincmAmt":"60000000", "spsIncmAdupYn":"Y", "spsAincmAmt":"15000000", "spsLbltAmt":"", "custClphnNbr":"2dyUlySsBz1q4SuZN4Mh+w==", "cmacDsCd":"01", "ciIdNbr":"1T92nJWyYKhjaLwkZ4ncHRuut5aaiX5KVNShc76zZK+6c1\/bSz+Xks31HMqV\/zZnYchDXPuHFAEACFJ2d\/MH7eMvcqOhMV6MCq9IqWZiq7mJRyvo7\/n5DmpDU8RdZiL5", "alcoStplCnt":"3", "alcoStplInfo":[ { "agrmntClseCd":"01", "agrmntDtHms":"20241023132752", "agrmntYn":"Y" }, { "agrmntClseCd":"02" ,"agrmntDtHms":"20241023132752" ,"agrmntYn":"Y" }, { "agrmntClseCd":"03", "agrmntDtHms":"20241023132752", "agrmntYn":"Y"} ], "prfSetngAmt":0, "otbkPrfYn":"N", "extrnlInstLnRpymntAmt":"", "fullRfnnYn":"N", "leaseDpstRefdAmt":"0", "leaseScsnYn":"N", "prfLthrGrntYn":"N", "hireCntDcd":"4", "cmppReowYn":"N", "lifeFrstBuygYn":"N", "kbMctxUnqCd":"KBA005688", "kbMctxAreaCd":"3", "buiRegiKeyNbr":"1047137196" }

응답 메시지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	dataCmn	공통부	Y	Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnCd	응답코드	Y	Field	String	4

* 대출금리한도조회결과 별도 통지

구분	이름	설명	필수여부	항목유형	데이터유형	길이
Body	dataCmn	공통부	Y	Group
Body	▫ fnclInstCd	금융기관코드	Y	Field	String	3
Body	▫ alncInstCd	제휴기관코드	Y	Field	String	3
Body	▫ tlgrRspnCd	응답코드	Y	Field	String	4

* 대출금리한도조회결과 별도 통지

응답 메시지 예제

Body

{ "dataCmn":{ "fnclInstCd":"KBK", "alncInstCd":"JHC", "tlgrRspnsCd":"0000" } }

kbank

API 상세보기

Kbank

아파트담보대출 대출금리 한도조회

요청 메시지

요청 메시지 예제

응답 메시지

응답 메시지 예제

아파트담보대출 대출금리 한도조회

요청 메시지

요청 메시지 예제

응답 메시지

응답 메시지 예제

알림

알림

알림