메인 콘텐츠로 건너뛰기
GET
입출금 내역 조회

인증

Authorization
string
header
필수

API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.

쿼리 매개변수

from
string<date>

거래일 시작. YYYY-MM-DD 형식의 KST 날짜이며 이 날을 포함합니다.

to
string<date>

거래일 끝. YYYY-MM-DD 형식의 KST 날짜이며 이 날을 포함합니다.

bankAccountId
string

계좌 목록 조회 응답의 계좌 id

transactionType
enum<string>

거래 유형 거래 유형. DEPOSIT: 입금. WITHDRAW: 출금. OTHER: 기타. 은행이 입금액과 출금액을 모두 0으로 준 거래이며 amount가 0입니다.

사용 가능한 옵션:
DEPOSIT,
WITHDRAW,
OTHER
cursor
string

이전 응답의 nextCursor. 받은 값을 그대로 보내세요. cursor는 받을 때의 조건(from, to, bankAccountId, transactionType)과 API 키에 묶입니다. 조건이나 API 키를 바꿨다면 cursor 없이 처음부터 다시 조회하세요.

limit
integer
기본값:100

한 번에 받을 최대 건수

필수 범위: 1 <= x <= 500

응답

조회 성공

입출금 내역 조회 결과

items
object[]
필수

볼타에서 거래가 바뀐 순서대로 담은 거래. 거래 시각 순서가 아닙니다.

status에 따라 모양이 다른 거래 항목. ACTIVE는 모든 필드를, REMOVED는 status와 id만 담습니다.

nextCursor
string
필수

다음 호출에 넘길 cursor. 마지막 페이지에서도 채워지니 저장해 두었다가 다음 수집 때 넘기세요.

hasMore
boolean
필수

지금 바로 이어 받을 내역이 더 있는지 여부. items가 비어 있어도 true일 수 있습니다.