List Expenses

Returns the expenses stored in Bolta in the order they changed in Bolta. Parameters, response, and cursor rules match List Revenues. An expense also moves back in the order when Bolta re-evaluates its payment status, so the same expense can arrive again with identical content. Overwrite it.

hasMore can be true even when items is empty, so decide whether to continue from hasMore. Expenses changed in the last 5 minutes are deferred to a later call. You need a Standard plan or higher, and the call deducts no points. Revenue and expense guide

GET

expenses

List Expenses

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

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

fetch('https://xapi.bolta.io/v1/expenses', 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/expenses",
  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/expenses"

	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/expenses")

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": "201",
      "type": "HOMETAX_TAX_INVOICE",
      "taxInvoice": {
        "ntsTransactionId": "20260901-20000000-00000201",
        "invoiceType": "TAX_INVOICE",
        "purpose": "CLAIM",
        "writtenDate": "2026-09-01",
        "issuedAt": "2026-09-01T02:00:00Z",
        "supplier": {
          "identificationNumberType": "BUSINESS",
          "identificationNumber": "3333333333",
          "taxRegistrationId": null,
          "organizationName": "주식회사 테스트공급",
          "representativeName": "테스트대표",
          "address": "경기도 테스트시 샘플로 2",
          "businessType": "도매",
          "businessItem": "도소매",
          "manager": {
            "name": "이공급",
            "email": "seller@example.com",
            "telephone": "02-1111-1111"
          }
        },
        "supplied": {
          "identificationNumberType": "BUSINESS",
          "identificationNumber": "1234567890",
          "taxRegistrationId": null,
          "organizationName": "주식회사 볼타테스트",
          "representativeName": "정대표",
          "address": "서울특별시 테스트구 테스트로 1",
          "businessType": "서비스",
          "businessItem": "소프트웨어 개발",
          "manager": {
            "name": "홍길동",
            "email": "tax@example.com",
            "telephone": null
          }
        },
        "trustee": null,
        "totalSupplyCost": 100000,
        "totalTax": 10000,
        "totalAmount": 110000,
        "paymentMeans": {
          "cash": null,
          "check": null,
          "bankBill": null,
          "accountReceivable": 110000
        },
        "description": null,
        "amendReason": null,
        "importDeclaration": null,
        "items": [
          {
            "date": "2026-09-01",
            "name": "사무용품",
            "specification": null,
            "quantity": 5,
            "unitPrice": 20000,
            "supplyCost": 100000,
            "tax": 10000,
            "description": null
          }
        ]
      }
    }
  ],
  "nextCursor": "djI6MTc4ODI1MzIwMDAwMDAwMDoyMDE6NGg4c2x6",
  "hasMore": true
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

Authorizations

Authorization

string

header

required

Append a colon to your API key, Base64-encode it, and put it in the header. Enter the API key as the username and leave the password empty.

Query Parameters

from

string<date>

Start of the transaction date range. A KST date in YYYY-MM-DD format, inclusive. Tax invoices are filtered by write date.

string<date>

End of the transaction date range. A KST date in YYYY-MM-DD format, inclusive.

type

enum<string>

Evidence type Evidence type. HOMETAX_TAX_INVOICE: A tax invoice or invoice registered with the NTS. Documents issued through Bolta and documents collected from Hometax use the same value. New values can be added, so skip items with an unknown value.

Available options:

HOMETAX_TAX_INVOICE

cursor

string

nextCursor from the previous response. Send it exactly as received. A cursor is bound to the path, filters (from, to, type), and key mode (test or live) it was issued for. After you change the filters or key mode, start over without a cursor.

limit

integer

default:100

Maximum number of items per call

Required range: 1 <= x <= 200

Response

Lookup succeeded

Revenue or expense change list

items

object[]

required

Items in the order they changed in Bolta, not by write date.

A revenue or expense item whose shape depends on status. ACTIVE carries type and the matching object; REMOVED carries only status and id.

Option 1
Option 2

Show child attributes

nextCursor

string

required

Cursor to pass on the next call. It is filled even on the last page, 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 Expenses

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

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

fetch('https://xapi.bolta.io/v1/expenses', 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/expenses",
  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/expenses"

	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/expenses")

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": "201",
      "type": "HOMETAX_TAX_INVOICE",
      "taxInvoice": {
        "ntsTransactionId": "20260901-20000000-00000201",
        "invoiceType": "TAX_INVOICE",
        "purpose": "CLAIM",
        "writtenDate": "2026-09-01",
        "issuedAt": "2026-09-01T02:00:00Z",
        "supplier": {
          "identificationNumberType": "BUSINESS",
          "identificationNumber": "3333333333",
          "taxRegistrationId": null,
          "organizationName": "주식회사 테스트공급",
          "representativeName": "테스트대표",
          "address": "경기도 테스트시 샘플로 2",
          "businessType": "도매",
          "businessItem": "도소매",
          "manager": {
            "name": "이공급",
            "email": "seller@example.com",
            "telephone": "02-1111-1111"
          }
        },
        "supplied": {
          "identificationNumberType": "BUSINESS",
          "identificationNumber": "1234567890",
          "taxRegistrationId": null,
          "organizationName": "주식회사 볼타테스트",
          "representativeName": "정대표",
          "address": "서울특별시 테스트구 테스트로 1",
          "businessType": "서비스",
          "businessItem": "소프트웨어 개발",
          "manager": {
            "name": "홍길동",
            "email": "tax@example.com",
            "telephone": null
          }
        },
        "trustee": null,
        "totalSupplyCost": 100000,
        "totalTax": 10000,
        "totalAmount": 110000,
        "paymentMeans": {
          "cash": null,
          "check": null,
          "bankBill": null,
          "accountReceivable": 110000
        },
        "description": null,
        "amendReason": null,
        "importDeclaration": null,
        "items": [
          {
            "date": "2026-09-01",
            "name": "사무용품",
            "specification": null,
            "quantity": 5,
            "unitPrice": 20000,
            "supplyCost": 100000,
            "tax": 10000,
            "description": null
          }
        ]
      }
    }
  ],
  "nextCursor": "djI6MTc4ODI1MzIwMDAwMDAwMDoyMDE6NGg4c2x6",
  "hasMore": true
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

Tax Invoice Issuance

Reverse Issuance

Issuer

Certificate

Tax Invoice Retrieval

Cash Receipt

Business Registration Status

Revenue and Expense

Bank Account Transactions

Bank Account Holder

Document Issuance

List Expenses

Authorizations

Query Parameters

Response