Retrieve Document Issuance

Retrieve the status of an issuance request. Hometax documents usually finish within 30 seconds, so poll every 5 to 10 seconds. A corporate registry takes a few minutes. If you send several Hometax document requests for the same business, each request starts after the previous one finishes. If the wait exceeds 1 hour, the request changes to FAILED and deducts no points. When the status is COMPLETED, download the original PDF from downloadUrl. The URL is valid for 5 minutes for Hometax documents and 1 minute for a corporate registry. A test key’s sample URL is valid for 5 minutes. When it expires, retrieve the result again to get a new one. The file is named {document name}_{business registration number}_{issue date}.pdf, and a corporate registry uses the corporation registration number instead. Document issuance guide

GET

documentIssuances

{issuanceKey}

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

import requests

url = "https://xapi.bolta.io/v1/documentIssuances/{issuanceKey}"

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/documentIssuances/{issuanceKey}', 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/documentIssuances/{issuanceKey}",
  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/documentIssuances/{issuanceKey}"

	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/documentIssuances/{issuanceKey}")

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

{
  "issuanceKey": "00000000-0000-4000-8000-000000000001",
  "clientReferenceId": "order-20260919-001",
  "type": "BUSINESS_REGISTRATION_PROOF",
  "language": "KO",
  "status": "COMPLETED",
  "requestedAt": "2026-09-19T03:00:00Z",
  "issuedOn": "2026-09-19",
  "retentionExpiresAt": "2026-10-19T03:00:30Z",
  "downloadUrl": "https://example.com/documents/00000000-0000-4000-8000-000000000001.pdf",
  "downloadUrlExpiresAt": "2026-09-19T03:05:30Z"
}

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.

Path Parameters

issuanceKey

string<uuid>

required

issuanceKey from the issuance request response

Response

Retrieved

Document issuance request and result

issuanceKey

string<uuid>

required

Issuance request identifier

clientReferenceId

string

required

Bolta-Client-Reference-Id used for the request

type

enum<string>

required

Document type

Available options:

BUSINESS_REGISTRATION_PROOF,

BUSINESS_REGISTRATION_CERTIFICATE,

TAX_PAYMENT_CERTIFICATE,

VAT_TAX_BASE_PROOF,

STANDARD_FINANCIAL_STATEMENT_PROOF,

CORPORATE_REGISTRY_VIEW,

CORPORATE_REGISTRY_ISSUANCE

language

enum<string>

required

Language of the issued document. Always KO for documents other than the business registration proof.

Available options:

KO,

EN

status

enum<string>

required

Issuance status

ACCEPTED: Accepted, not yet submitted to the agency
SUBMITTED: Submitted to the agency, waiting for the result
COMPLETED: Issued
FAILED: Issuance failed. No points are deducted. For Hometax documents, check the certificate, tax arrears, and filing status. For a corporate registry, check the corporation registration number and the corporation's type and status. If nothing is wrong, request again shortly. Use a new Bolta-Client-Reference-Id when you request again
ACTION_REQUIRED: Bolta is checking the result. Do not request the same document again; wait until it changes to COMPLETED or FAILED

Available options:

ACCEPTED,

SUBMITTED,

COMPLETED,

FAILED,

ACTION_REQUIRED

requestedAt

string<date-time>

required

Time the request was accepted (UTC)

issuedOn

string<date> | null

required

Issue date printed on the original PDF. For a corporate registry, the view or issue date. Filled only when COMPLETED.

retentionExpiresAt

string<date-time> | null

required

Retention end time (UTC). 30 days after issuance. Filled only when COMPLETED.

downloadUrl

string<uri> | null

required

Original PDF URL, valid for 5 minutes for Hometax documents and 1 minute for a corporate registry. Filled only when COMPLETED and within the retention period. For test keys, a sample PDF URL valid for 5 minutes for every document type.

downloadUrlExpiresAt

string<date-time> | null

required

downloadUrl expiry time (UTC)

Retrieve Document Issuance

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

import requests

url = "https://xapi.bolta.io/v1/documentIssuances/{issuanceKey}"

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/documentIssuances/{issuanceKey}', 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/documentIssuances/{issuanceKey}",
  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/documentIssuances/{issuanceKey}"

	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/documentIssuances/{issuanceKey}")

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

{
  "issuanceKey": "00000000-0000-4000-8000-000000000001",
  "clientReferenceId": "order-20260919-001",
  "type": "BUSINESS_REGISTRATION_PROOF",
  "language": "KO",
  "status": "COMPLETED",
  "requestedAt": "2026-09-19T03:00:00Z",
  "issuedOn": "2026-09-19",
  "retentionExpiresAt": "2026-10-19T03:00:30Z",
  "downloadUrl": "https://example.com/documents/00000000-0000-4000-8000-000000000001.pdf",
  "downloadUrlExpiresAt": "2026-09-19T03:05:30Z"
}

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

Retrieve Document Issuance

Authorizations

Path Parameters

Response