Retrieve Document Issuance

Retrieve the status of an issuance request. Issuance usually finishes within 30 seconds, so poll every 5 to 10 seconds. Bolta processes one request at a time for each business. If you send several at once, each request starts after the previous one finishes. When the status is COMPLETED, download the original PDF from downloadUrl. The 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. Test keys return a sample PDF URL. 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

Base64-encode your API key and pass it. 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

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
SUBMITTED: Submitted to Hometax, waiting for the result
COMPLETED: Issued
FAILED: Issuance failed. No points are deducted. Check the certificate, tax arrears, and filing status, then request again with a new Bolta-Client-Reference-Id
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. 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. Filled only when COMPLETED and within the retention period. For test keys, a sample PDF URL.

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

Bank Account Transactions

Document Issuance

Retrieve Document Issuance

Authorizations

Path Parameters

Response