세금계산서 PDF 조회
발행 완료한 세금계산서(정발행, 역발행, 수정세금계산서)의 PDF 다운로드 주소를 조회합니다. 발행을 요청한 API 키로 호출하세요. 포인트를 차감하지 않습니다. 사업자 대상 발행은 발행 완료 후 서버가 PDF를 자동으로 생성합니다. 웹훅은 PDF 생성과 별개로 전송하므로, 발행 결과 웹훅이나 내용 조회로 발행 완료를 확인한 뒤 이 API를 호출하세요. 준비된 PDF가 있으면 첫 조회에서도 200과 5분 동안 유효한 다운로드 주소를 반환하며, 이후 조회에서도 재사용합니다. 개인 대상처럼 자동 생성하지 않은 건은 조회 요청으로 생성을 시작합니다. 사업자 대상 발행을 포함해 PDF가 생성 중이면 202를 반환합니다. 첫 조회나 이후 조회에서 202를 받으면 Retry-After 초 뒤 같은 요청을 다시 보내세요. 주소가 만료되면 다시 호출해 새 주소를 받으세요. 테스트 키는 발행 완료한 건에 200과 샘플 PDF 주소를 반환합니다. 세금계산서 PDF 조회 가이드
GET
/
v1
/
taxInvoices
/
{issuanceKey}
/
pdf
세금계산서 PDF 조회
curl --request GET \
--url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/pdf \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/pdf"
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/taxInvoices/{issuanceKey}/pdf', 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/taxInvoices/{issuanceKey}/pdf",
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/taxInvoices/{issuanceKey}/pdf"
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/taxInvoices/{issuanceKey}/pdf")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/pdf")
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": "8D529FAD3EBAE050B79CE943CCC7CEDE",
"status": "READY",
"downloadUrl": "https://example.com/tax-invoice-pdfs/8D529FAD3EBAE050B79CE943CCC7CEDE.pdf",
"downloadUrlExpiresAt": "2026-09-24T03:05:00Z",
"filename": "전자세금계산서_20260924_공급받는자 상호_20260924-10000000-00000001.pdf"
}{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
"status": "PENDING",
"downloadUrl": null,
"downloadUrlExpiresAt": null,
"filename": null
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}인증
응답
PDF 준비 완료
세금계산서 PDF 준비 상태와 다운로드 주소
세금계산서 PDF 조회
curl --request GET \
--url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/pdf \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/pdf"
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/taxInvoices/{issuanceKey}/pdf', 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/taxInvoices/{issuanceKey}/pdf",
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/taxInvoices/{issuanceKey}/pdf"
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/taxInvoices/{issuanceKey}/pdf")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/pdf")
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": "8D529FAD3EBAE050B79CE943CCC7CEDE",
"status": "READY",
"downloadUrl": "https://example.com/tax-invoice-pdfs/8D529FAD3EBAE050B79CE943CCC7CEDE.pdf",
"downloadUrlExpiresAt": "2026-09-24T03:05:00Z",
"filename": "전자세금계산서_20260924_공급받는자 상호_20260924-10000000-00000001.pdf"
}{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
"status": "PENDING",
"downloadUrl": null,
"downloadUrlExpiresAt": null,
"filename": null
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}