Tax Invoice PDF

What you can retrieve

Download a tax invoice issued through the Open API as a PDF. The PDF uses the same layout as the one in the Bolta dashboard.

Path	Purpose
`GET /v1/taxInvoices/{issuanceKey}/pdf`	Retrieve the tax invoice PDF download URL

Requirements

Standard issuance (issue), reverse issuance (issueRequest), and amended tax invoices (amend) are all supported.
The issuance must be finished. Call this API after you receive the issuance result webhook (TAX_INVOICE_ISSUANCE_SUCCESS) or after Retrieve Tax Invoice reports the issuance as complete.
For reverse issuance, the PDF is available after the supplier approves and issuance finishes. If the supplier has not approved yet or has rejected the request, the API returns 400 TAX_INVOICE_RETRIEVE_NOT_AVAILABLE.
The PDF of an amended tax invoice marks the title as an amendment or cancellation and includes the amendment reason.
Call it with the API key that requested the issuance. If you rotate or revoke a key, you can no longer retrieve PDFs for invoices issued with that key, so download the PDFs you need before you change keys.

Pricing

This API does not deduct points.

Retrieving the PDF

Request

curl https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/pdf \
  -H "Authorization: Basic {apiKey}"

Set issuanceKey to the value from the issuance response.

Response

The first call starts generating the PDF. While the PDF is being generated, the API returns 202 Accepted with a Retry-After header. Wait that many seconds and send the same request again.

HTTP/1.1 202 Accepted
Retry-After: 2

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
  "status": "PENDING",
  "downloadUrl": null,
  "downloadUrlExpiresAt": null,
  "filename": null
}

When the PDF is ready, the API returns 200 OK with a download URL. Bolta does not regenerate a PDF once it exists, so later calls get 200 right away.

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

Field	Type	Description
`issuanceKey`	string	The requested `issuanceKey`
`status`	string	`PENDING` (being generated), `READY` (ready)
`downloadUrl`	string or null	PDF URL. Valid for 5 minutes
`downloadUrlExpiresAt`	string or null	URL expiry time (UTC)
`filename`	string or null	File name saved on download

downloadUrl, downloadUrlExpiresAt, and filename have values only when the status is READY. When the URL expires, send the same request again to get a new one. The URL contains a signature, so do not write the full URL to logs or analytics tools. The file name is {type}_{write date}_{supplied party name}_{approval number}.pdf. The download URL sends the same name in the Content-Disposition header. Clients that do not support Korean file names receive a name that keeps only ASCII letters and digits.

If the supplied party is an individual, the resident registration number sent in the issuance request appears unmasked in the PDF. Handle the file as personal information when you store or share it.

Test key

Issuances made with a test key have no real tax invoice. Instead, the API returns 200 and a sample PDF URL right away. The sample has the same content for every issuance. The URL lifetime (5 minutes), retrieving again after expiry, and the file name delivery work the same as with a live key, so use a test key to check your download integration. Test keys never return 202. Check the logic that calls again after Retry-After with a live key.

Rate limits

When 10 PDFs are being generated for the same business, or 20 PDFs are being generated for the same API key, the API returns 429 TOO_MANY_IN_FLIGHT with a Retry-After header. The limit applies only to PDFs that need to be generated. Calls for PDFs that you already requested or that are ready are not blocked. To download many PDFs at once, split your requests so that no more than 10 per business and 20 per key are in progress. Request the next one after an earlier PDF is ready.

Errors

Status code	Error code	Condition
`400`	`TAX_INVOICE_RETRIEVE_NOT_AVAILABLE`	Issuance not finished or failed. For reverse issuance, the supplier has not approved or has rejected the request. Check the issuance result and call again
`400`	`INVALID_DOCUMENT`	The PDF cannot be generated from the document data stored in Bolta. Contact Bolta with the `issuanceKey`
`401`	-	API key authentication failed. Empty response body
`403`	`FORBIDDEN`	Not the API key that requested the issuance. Also applies to issuances made with a key you have since rotated or revoked
`404`	`NOT_FOUND`	Unknown `issuanceKey`
`429`	`TOO_MANY_IN_FLIGHT`	10 PDFs in progress for the same business or 20 for the same API key. Call again after `Retry-After` (60 seconds)
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`PDF_GENERATION_FAILED`	The PDF could not be generated after several attempts. Send the same request after `Retry-After` (600 seconds) to generate it again. If it keeps failing, contact Bolta with the `issuanceKey`
`503`	`SERVICE_UNAVAILABLE`	Temporary internal API communication error

If you call again before Retry-After after receiving PDF_GENERATION_FAILED, you get the same error.

API Introduction

API Guides

Use Cases

SDK / No-code

What you can retrieve

Requirements

Pricing

Retrieving the PDF

Request

Response

Test key

Rate limits

Errors

​What you can retrieve

​Requirements

​Pricing

​Retrieving the PDF

​Request

​Response

​Test key

​Rate limits

​Errors

​Related documents

What you can retrieve

Requirements

Pricing

Retrieving the PDF

Request

Response

Test key

Rate limits

Errors

Related documents