List Expenses
Returns the expenses stored in Bolta in the order they changed in Bolta. Parameters, response, and cursor rules match List Revenues.
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
/
v1
/
expenses
List Expenses
curl --request GET \
--url https://xapi.bolta.io/v1/expenses \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/expenses"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://xapi.bolta.io/v1/expenses")
.header("Authorization", "Basic <encoded-value>")
.asString();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
Query Parameters
Response
Lookup succeeded
Revenue or expense change list
List Expenses
curl --request GET \
--url https://xapi.bolta.io/v1/expenses \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/expenses"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://xapi.bolta.io/v1/expenses")
.header("Authorization", "Basic <encoded-value>")
.asString();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>"
}