API 레퍼런스  >  은행 연동

계좌 거래내역 조회

수집된 계좌 거래내역을 조회합니다. 거래일 최신순(거래일, 거래시각 내림차순)으로 반환합니다.

과금 안내: 거래내역은 건당 과금됩니다. 응답 페이지에 담긴 거래 중 처음 조회되는 건만 과금하며, 이미 조회한 거래를 다시 조회하면 과금하지 않습니다.

선불 업체는 조회 시 선불 잔액에서 차감됩니다. 잔액이 이번 페이지 과금액보다 적으면 -20502 오류를 반환하며 데이터는 반환하지 않습니다. (limit을 줄여 조회하거나 잔액을 충전해 주세요.)

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 settingId Long Y 계좌 설정 ID (Path). 계좌 등록·목록 조회 응답의 settingId 1 이상의 숫자
2 page Integer N 조회할 페이지 번호 (Query) 1 이상, 기본값 1
3 limit Integer N 페이지당 건수 (Query) 1~100, 기본값 20
4 startDate String 10 N 거래일 조회 시작일 (Query) YYYY-MM-DD, 시작일 포함
5 endDate String 10 N 거래일 조회 종료일 (Query) YYYY-MM-DD, 종료일 포함. 시작일보다 빠를 수 없음
Request 샘플 ›
Request 샘플
GET https://api.sendbill.co.kr/api/v1/accounts/65/transactions?page=1&limit=20&startDate=2026-10-01&endDate=2026-10-14

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Accept-Charset: UTF-8

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 code Integer 처리 결과 코드. 성공 시 200, 실패 시 음수
2 data.totalCount Long 조회 조건에 맞는 전체 거래 건수 (현재 페이지 건수 아님)
3 data.items Array 거래내역 목록
4 data.items[].transactionId Long 거래 ID
5 data.items[].settingId Long 계좌 설정 ID
6 data.items[].txnDate String 거래일 (YYYY-MM-DD)
7 data.items[].txnTime String 거래시각
8 data.items[].txnType String 거래 구분
9 data.items[].txnAmount Number 거래금액
10 data.items[].balanceAfterTxn Number 거래 후 잔액
11 data.items[].counterpartName String 거래 상대방
12 data.items[].description String 적요
13 data.items[].currencyCode String 통화 코드
14 data.items[].bankTxnNo String 은행 거래번호
15 data.items[].createdAt String 수집일시 (YYYY-MM-DD HH:MM:SS)
Response JSON 샘플 › 
{
    "code": 200,
    "data": {
        "totalCount": 135,
        "items": [
            {
                "transactionId": 9001,
                "settingId": 65,
                "txnDate": "2026-10-14",
                "txnTime": "143015",
                "txnType": "입금",
                "txnAmount": 150000,
                "balanceAfterTxn": 1234567,
                "counterpartName": "홍길동",
                "description": "급여",
                "currencyCode": "KRW",
                "bankTxnNo": "20261014000123",
                "createdAt": "2026-10-14 15:00:02"
            }
        ]
    }
}