본문으로 바로가기

ASSETS

자산·기관 연동

카드, 계좌, 홈택스, 스토어 자산과 기관 연결 상태를 조회해요. 신규 연동·재연동 요청 가능.

기관 상태, 자산, 잔액 흐름

자산은 데이터 출처를 설명해요. HOME_TAX_ACCOUNT 응답의 인증서 필드만으로 발행 설정 판단 금지.

  • GET/api/public-docs/organizations

    은행, 카드, 증권, 홈택스 등 기관의 지원 상태와 현재 연결 상태를 조회해요.

  • POST/api/public-docs/organizations/certifications/connect

    인증서로 기관 신규 연동을 요청해요.

  • POST/api/public-docs/organizations/certifications/reconnect

    기존 인증서 연동의 재연동을 요청해요.

  • POST/api/public-docs/organizations/login/connect

    기관 로그인 ID/PW로 신규 연동을 요청해요.

  • POST/api/public-docs/organizations/login/reconnect

    기존 기관 연결의 재연동을 요청해요.

  • POST/api/public-docs/assets

    카드, 계좌, 홈택스, 스토어 등 거래 수집 자산을 조회해요.

  • POST/api/public-docs/cards

    수기 카드 자산을 생성해요.

  • POST/api/public-docs/bank-accounts

    수기 계좌 자산을 생성해요.

  • PUT/api/public-docs/bank-accounts/password

    계좌 비밀번호를 설정해요.

  • DELETE/api/public-docs/bank-accounts/password

    저장된 계좌 비밀번호를 삭제해요.

  • POST/api/public-docs/balances

    계좌별 잔액 흐름을 시계열로 조회해요.

  • POST/api/public-docs/daily-financial-report

    잔액, 계좌 거래, 환율, 자산 정보를 조합한 자금일보 표를 조회해요.

주요 요청 필드

assetTypeoptional
string
예: CARD, BANK_ACCOUNT, HOME_TAX_ACCOUNT.
startDaterequired
string (YYYY-MM-DD)
조회 시작일. 기간 기반 조회는 1회 최대 31일 기준.
endDaterequired
string (YYYY-MM-DD)
조회 종료일. 더 긴 기간은 31일 이하 분할 호출.
useCurrentExchangeRateoptional
boolean
자금일보에서 현재 환율 적용 여부 지정.
organizationId / loginId / passwordrequired
string
기관 로그인 연동·재연동 시 사용.

POST /api/public-docs/balances

$ curl -X POST https://app.granter.biz/api/public-docs/balances \    -H "Content-Type: application/json" \    -H "Authorization: Basic <BASE64(API_KEY:)>" \    -d '{"startDate":"2026-03-01","endDate":"2026-03-07"}' { "data": [{ "balance": 152400000 }] }

예시를 복사해 첫 요청을 보내세요

API 키는 Basic 인증으로 넣어요. 필요한 필드와 응답은 문서에서 확인.