List Bank Account Transactions

Returns the transactions Bolta fetched from the bank, in the order they changed in Bolta. This is not transaction time order. Newly loaded or visible-again transactions come as ACTIVE. Transactions hidden from the dashboard come as REMOVED with only the id. The same id can arrive more than once, so apply items in the order you receive them: overwrite or delete by id.

hasMore can be true even when items is empty, so decide whether to continue from hasMore. The API fills nextCursor on the last page too. Save it and pass it on your next call to receive only the transactions that changed since then. Transactions changed in the last 5 minutes wait for a later call. You need a Standard plan or higher, and the call deducts no points. Bank account transactions guide

GET

bankAccounts

transactions

List Bank Account Transactions

curl --request GET \
  --url https://xapi.bolta.io/v1/bankAccounts/transactions \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://xapi.bolta.io/v1/bankAccounts/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xapi.bolta.io/v1/bankAccounts/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xapi.bolta.io/v1/bankAccounts/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/bankAccounts/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "status": "ACTIVE",
      "id": "1",
      "bankAccountId": "1",
      "bank": "KB_STAR",
      "accountNumber": "123456-01-234567",
      "transactionAt": "2026-09-01T00:30:00Z",
      "transactionType": "DEPOSIT",
      "amount": 1100000,
      "balanceAfterTransaction": 5100000,
      "description": "주식회사볼타",
      "currencyCode": "KRW"
    },
    {
      "status": "ACTIVE",
      "id": "2",
      "bankAccountId": "1",
      "bank": "KB_STAR",
      "accountNumber": "123456-01-234567",
      "transactionAt": "2026-09-01T06:10:00Z",
      "transactionType": "WITHDRAW",
      "amount": 55000,
      "balanceAfterTransaction": 5045000,
      "description": "통신요금",
      "currencyCode": "KRW"
    },
    {
      "status": "ACTIVE",
      "id": "3",
      "bankAccountId": "2",
      "bank": "SHINHAN",
      "accountNumber": "110-123-456789",
      "transactionAt": "2026-09-02T01:00:00Z",
      "transactionType": "DEPOSIT",
      "amount": 330000,
      "balanceAfterTransaction": 1330000,
      "description": "홍길동",
      "currencyCode": "KRW"
    }
  ],
  "nextCursor": "djE6MTc4ODMzMjQwMDAwMDAwMDoz",
  "hasMore": true
}

Authorizations

Authorization

string

header

required

Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty.

Query Parameters

from

string<date>

Start of the transaction date range, inclusive. Use a YYYY-MM-DD date in KST.

string<date>

End of the transaction date range, inclusive. Use a YYYY-MM-DD date in KST. The API rejects a to earlier than from with 400.

bankAccountId

string

Account id from the account list response. The API rejects an unknown account or another business's account with 404.

transactionType

enum<string>

Transaction type Transaction type. DEPOSIT: Deposit. WITHDRAW: Withdrawal. OTHER: Other. The bank reported zero for both the deposit and withdrawal amounts, so amount is 0.

Available options:

DEPOSIT,

WITHDRAW,

OTHER

cursor

string

nextCursor from the previous response. Send it exactly as received. If you change the filters, start over without a cursor.

limit

integer

default:100

Maximum number of items per call

Required range: 1 <= x <= 500

Response

Lookup succeeded

Bank account transaction list result

items

object[]

required

Transactions in the order they changed in Bolta, not in transaction time order.

A transaction item whose shape depends on status. ACTIVE carries every field; REMOVED carries only status and id.

Option 1
Option 2

Show child attributes

nextCursor

string

required

Cursor for the next call. The API fills it on the last page too, so save it and pass it on your next collection.

hasMore

boolean

required

Whether more items are available right now. Can be true even when items is empty.

List Bank Account Transactions

curl --request GET \
  --url https://xapi.bolta.io/v1/bankAccounts/transactions \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://xapi.bolta.io/v1/bankAccounts/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xapi.bolta.io/v1/bankAccounts/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xapi.bolta.io/v1/bankAccounts/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/bankAccounts/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "status": "ACTIVE",
      "id": "1",
      "bankAccountId": "1",
      "bank": "KB_STAR",
      "accountNumber": "123456-01-234567",
      "transactionAt": "2026-09-01T00:30:00Z",
      "transactionType": "DEPOSIT",
      "amount": 1100000,
      "balanceAfterTransaction": 5100000,
      "description": "주식회사볼타",
      "currencyCode": "KRW"
    },
    {
      "status": "ACTIVE",
      "id": "2",
      "bankAccountId": "1",
      "bank": "KB_STAR",
      "accountNumber": "123456-01-234567",
      "transactionAt": "2026-09-01T06:10:00Z",
      "transactionType": "WITHDRAW",
      "amount": 55000,
      "balanceAfterTransaction": 5045000,
      "description": "통신요금",
      "currencyCode": "KRW"
    },
    {
      "status": "ACTIVE",
      "id": "3",
      "bankAccountId": "2",
      "bank": "SHINHAN",
      "accountNumber": "110-123-456789",
      "transactionAt": "2026-09-02T01:00:00Z",
      "transactionType": "DEPOSIT",
      "amount": 330000,
      "balanceAfterTransaction": 1330000,
      "description": "홍길동",
      "currencyCode": "KRW"
    }
  ],
  "nextCursor": "djE6MTc4ODMzMjQwMDAwMDAwMDoz",
  "hasMore": true
}

Tax Invoice Issuance

Reverse Issuance

Issuer

Certificate

Tax Invoice Retrieval

Cash Receipt

Business Registration Status

Bank Account Transactions

List Bank Account Transactions

Authorizations

Query Parameters

Response