자산·기관 연동 API

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

GET/api/public-docs/organizations
은행, 카드, 증권, 홈택스 등 기관의 지원 상태와 현재 연결 상태를 조회해요.
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/balances
계좌별 잔액 흐름을 시계열로 조회해요.
POST/api/public-docs/daily-financial-report
잔액, 계좌 거래, 환율, 자산 정보를 조합한 자금일보 표를 조회해요.

파라미터	타입	필수	설명
assetType	string	optional	예: CARD, BANK_ACCOUNT, HOME_TAX_ACCOUNT.
startDate	string (YYYY-MM-DD)	required	조회 시작일. 기간 기반 조회는 1회 최대 31일 기준.
endDate	string (YYYY-MM-DD)	required	조회 종료일. 더 긴 기간은 31일 이하 분할 호출.
useCurrentExchangeRate	boolean	optional	자금일보에서 현재 환율 적용 여부 지정.
organizationId / loginId / password	string	required	기관 로그인 연동·재연동 시 사용.

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 }] }

자산·기관 연동