서류 발급 결과 조회

발급 요청의 상태를 조회합니다. 보통 30초 안에 끝나니 5~10초 간격으로 조회하세요. 볼타는 한 사업자의 요청을 한 건씩 차례로 처리하므로 여러 건을 한꺼번에 보내면 뒤 요청은 앞 요청이 끝난 뒤 시작합니다. COMPLETED가 되면 downloadUrl로 원본 PDF를 내려받으세요. 주소는 5분 동안 유효하고, 만료되면 다시 조회해 새 주소를 받으세요. 파일 이름은 {서류명}_{사업자등록번호}_{발급일}.pdf입니다. 테스트 키는 샘플 PDF 주소를 줍니다. 서류 발급 가이드

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"
}

인증

Authorization

string

header

필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

경로 매개변수

issuanceKey

string<uuid>

필수

발급 요청 응답의 issuanceKey

응답

조회 성공

서류 발급 요청과 결과

issuanceKey

string<uuid>

필수

발급 요청 식별자

clientReferenceId

string

필수

요청에 사용한 Bolta-Client-Reference-Id

type

enum<string>

필수

서류 종류

사용 가능한 옵션:

BUSINESS_REGISTRATION_PROOF,

BUSINESS_REGISTRATION_CERTIFICATE,

TAX_PAYMENT_CERTIFICATE,

VAT_TAX_BASE_PROOF,

STANDARD_FINANCIAL_STATEMENT_PROOF

language

enum<string>

필수

발급한 서류의 언어. 사업자등록증명이 아닌 서류는 항상 KO입니다.

사용 가능한 옵션:

KO,

EN

status

enum<string>

필수

발급 상태

ACCEPTED: 접수
SUBMITTED: 홈택스 신청 완료, 결과 대기
COMPLETED: 발급 완료
FAILED: 발급 실패. 포인트를 차감하지 않습니다. 인증서, 체납, 신고 여부를 확인하고 새 Bolta-Client-Reference-Id로 다시 요청하세요
ACTION_REQUIRED: 볼타가 결과 확인 중. 같은 서류를 다시 요청하지 마세요. COMPLETED 또는 FAILED로 바뀔 때까지 기다리세요

사용 가능한 옵션:

ACCEPTED,

SUBMITTED,

COMPLETED,

FAILED,

ACTION_REQUIRED

requestedAt

string<date-time>

필수

요청을 접수한 시각(UTC)

issuedOn

string<date> | null

필수

원본 PDF에 적힌 발급일. COMPLETED에서만 채웁니다.

retentionExpiresAt

string<date-time> | null

필수

보관 만료 시각(UTC). 발급 후 30일입니다. COMPLETED에서만 채웁니다.

downloadUrl

string<uri> | null

필수

원본 PDF 주소. 5분 동안 유효합니다. COMPLETED이고 보관 기간 안일 때만 채웁니다. 테스트 키는 샘플 PDF 주소입니다.

downloadUrlExpiresAt

string<date-time> | null

필수

downloadUrl 만료 시각(UTC)

서류 발급 결과 조회

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"
}

세금계산서 발행

세금계산서 역발행

발급자

인증서

세금계산서 조회

현금영수증

사업자등록 상태 조회

입출금내역 조회

서류 발급

서류 발급 결과 조회

인증

경로 매개변수

응답