List Revenues
Returns the revenue stored in Bolta in the order it changed in Bolta, not by write date. Revenue visible in the dashboard arrives as ACTIVE. Revenue hidden because it was archived or deactivated arrives as REMOVED with only its id. The same id can arrive more than once, so overwrite or delete by id in the order you receive items. Revenue collected from Hometax whose details are still being filled arrives as PENDING with only its id, and the same id arrives again as ACTIVE once the details are filled.
hasMore can be true even when items is empty, so decide whether to continue from hasMore. The API fills nextCursor even on the last page. Save it and pass it next time to receive only the revenue that changed since then. Revenue changed in the last 5 minutes is deferred to a later call. You need a Standard plan or higher, and the call deducts no points. Revenue and expense guide
curl --request GET \
--url https://xapi.bolta.io/v1/revenues \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/revenues"
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/revenues', 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/revenues",
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/revenues"
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/revenues")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/revenues")
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": "101",
"type": "HOMETAX_TAX_INVOICE",
"taxInvoice": {
"ntsTransactionId": "20260901-10000000-00000101",
"invoiceType": "TAX_INVOICE",
"purpose": "CLAIM",
"writtenDate": "2026-09-01",
"issuedAt": "2026-09-01T05:12:00Z",
"supplier": {
"identificationNumberType": "BUSINESS",
"identificationNumber": "1234567890",
"taxRegistrationId": null,
"organizationName": "주식회사 볼타테스트",
"representativeName": "정대표",
"address": "서울특별시 테스트구 테스트로 1",
"businessType": "서비스",
"businessItem": "소프트웨어 개발",
"manager": {
"name": "홍길동",
"email": "tax@example.com",
"telephone": "02-0000-0000"
}
},
"supplied": {
"identificationNumberType": "BUSINESS",
"identificationNumber": "1111111111",
"taxRegistrationId": null,
"organizationName": "주식회사 테스트고객",
"representativeName": "테스트대표",
"address": "경기도 테스트시 샘플로 2",
"businessType": "도매",
"businessItem": "도소매",
"manager": {
"name": "김담당",
"email": "buyer@example.com",
"telephone": null
}
},
"trustee": null,
"totalSupplyCost": 1000000,
"totalTax": 100000,
"totalAmount": 1100000,
"paymentMeans": {
"cash": null,
"check": null,
"bankBill": null,
"accountReceivable": 1100000
},
"description": null,
"amendReason": null,
"importDeclaration": null,
"items": [
{
"date": "2026-09-01",
"name": "컨설팅",
"specification": null,
"quantity": 1,
"unitPrice": 600000,
"supplyCost": 600000,
"tax": 60000,
"description": null
},
{
"date": "2026-09-01",
"name": "교육",
"specification": null,
"quantity": 2,
"unitPrice": 200000,
"supplyCost": 400000,
"tax": 40000,
"description": null
}
]
}
},
{
"status": "REMOVED",
"id": "104"
},
{
"status": "PENDING",
"id": "105"
}
],
"nextCursor": "djI6MTc4ODY1NjQwMDAwMDAwMDoxMDU6MXVpMmNn",
"hasMore": false
}Authorizations
Query Parameters
Response
Lookup succeeded
Revenue or expense change list
curl --request GET \
--url https://xapi.bolta.io/v1/revenues \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/revenues"
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/revenues', 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/revenues",
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/revenues"
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/revenues")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/revenues")
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": "101",
"type": "HOMETAX_TAX_INVOICE",
"taxInvoice": {
"ntsTransactionId": "20260901-10000000-00000101",
"invoiceType": "TAX_INVOICE",
"purpose": "CLAIM",
"writtenDate": "2026-09-01",
"issuedAt": "2026-09-01T05:12:00Z",
"supplier": {
"identificationNumberType": "BUSINESS",
"identificationNumber": "1234567890",
"taxRegistrationId": null,
"organizationName": "주식회사 볼타테스트",
"representativeName": "정대표",
"address": "서울특별시 테스트구 테스트로 1",
"businessType": "서비스",
"businessItem": "소프트웨어 개발",
"manager": {
"name": "홍길동",
"email": "tax@example.com",
"telephone": "02-0000-0000"
}
},
"supplied": {
"identificationNumberType": "BUSINESS",
"identificationNumber": "1111111111",
"taxRegistrationId": null,
"organizationName": "주식회사 테스트고객",
"representativeName": "테스트대표",
"address": "경기도 테스트시 샘플로 2",
"businessType": "도매",
"businessItem": "도소매",
"manager": {
"name": "김담당",
"email": "buyer@example.com",
"telephone": null
}
},
"trustee": null,
"totalSupplyCost": 1000000,
"totalTax": 100000,
"totalAmount": 1100000,
"paymentMeans": {
"cash": null,
"check": null,
"bankBill": null,
"accountReceivable": 1100000
},
"description": null,
"amendReason": null,
"importDeclaration": null,
"items": [
{
"date": "2026-09-01",
"name": "컨설팅",
"specification": null,
"quantity": 1,
"unitPrice": 600000,
"supplyCost": 600000,
"tax": 60000,
"description": null
},
{
"date": "2026-09-01",
"name": "교육",
"specification": null,
"quantity": 2,
"unitPrice": 200000,
"supplyCost": 400000,
"tax": 40000,
"description": null
}
]
}
},
{
"status": "REMOVED",
"id": "104"
},
{
"status": "PENDING",
"id": "105"
}
],
"nextCursor": "djI6MTc4ODY1NjQwMDAwMDAwMDoxMDU6MXVpMmNn",
"hasMore": false
}