API 레퍼런스  >  은행 연동

계좌 최신 잔고 조회

수집된 잔고 중 가장 최근 잔고를 조회합니다. 계좌 상태와 관계없이 마지막으로 수집된 잔고를 반환합니다.

잔고가 수집된 적이 없으면 balance, scrapingDtm이 null입니다. 잔고 조회는 과금하지 않습니다.

GET https://dev.sendbill.co.kr:444/api/v1/accounts/{settingId}/balance

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 settingId Long Y 계좌 설정 ID (Path). 계좌 등록·목록 조회 응답의 settingId 1 이상의 숫자
Request 샘플 ›
Request 샘플
GET https://api.sendbill.co.kr/api/v1/accounts/65/balance

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Accept-Charset: UTF-8

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 code Integer 처리 결과 코드. 성공 시 200, 실패 시 음수
2 data.settingId Long 계좌 설정 ID
3 data.balance Number 최신 잔고. 수집된 잔고가 없으면 null
4 data.scrapingDtm String 잔고 수집 시각 (YYYY-MM-DDTHH:mm:ss). 없으면 null
5 data.lastSuccessDtm String 마지막 수집 성공 시각 (YYYY-MM-DDTHH:mm:ss). 없으면 null
Response JSON 샘플 › 
{
    "code": 200,
    "data": {
        "settingId": 65,
        "balance": 1234567,
        "scrapingDtm": "2026-10-06T13:06:36",
        "lastSuccessDtm": "2026-10-06T13:06:40"
    }
}