What you can issue
Issue National Tax Service certificates from Hometax or a certified copy of corporate registry, and download the original PDF. The API accepts the request first and issues the document afterward. Retrieve the result with theissuanceKey from the accepted response.
Requirements
- Hometax documents are issued for the business that owns the API key. Register a joint certificate in the Bolta dashboard.
- A corporate registry is issued for the corporation in
document.corporationNumber. Supported corporation types are stock company, limited company, general partnership company, limited partnership company, limited liability company, incorporated association, incorporated foundation, medical corporation, cooperative (including social cooperative), and other corporate entity (such as a patent corporation). No joint certificate is needed.
Pricing
Each document deducts the points below. A failed issuance deducts nothing.Supported documents
- Business registration certificate reissue: Bolta prints
reasonas is on the certificate. Enter the actual reason, for example분실(lost). The API trims leading and trailing spaces. It returns400 INVALID_REQUESTif the reason is empty, longer than 10 characters, or contains control characters. - Business registration proof: If
languageis missing, the API returns400 INVALID_REQUEST. Bolta issues the English version (EN) with the English business information registered in Hometax. If that information is missing or malformed, the request ends asFAILEDand deducts no points. To change the English details, update them in Hometax first. - Tax payment certificate: Hometax does not issue it while national taxes are in arrears. The certificate is valid for 30 days from the issue date.
- VAT tax base proof: Set
fromto January or July andtoto June or December.fromcannot be later thanto; otherwise the API returns400 INVALID_REQUEST. One request covers up to five years. - Standard financial statement proof: For a corporation with a December year end, enter
2025-12for fiscal year 2025. For a sole proprietor, only the year is used. Only fiscal years with a filed corporate or comprehensive income tax return can be issued. For a fiscal year that has not ended (a year end in or after the current month), the API returns400 PERIOD_NOT_CLOSEDand reserves no points. If the fiscal year has ended but the return is not filed yet, the request ends asFAILEDand deducts no points. - Certified copy of corporate registry: Bolta issues it from the Internet Registry Office. Enter
corporationNumberas digits only, such as1101111234567, or with a hyphen, such as110111-1234567. If the format is wrong, the API returns400 INVALID_REQUEST. SetcancelledEntriesto choose whether cancelled entries are included. If you omit it, the API returns400 INVALID_REQUEST. The view copy is for checking the contents. Request the submission copy when you need to submit the document to a government office or bank. If another request is issuing the same document with the samecancelledEntriesfor the same corporation, the API returns409 TARGET_BUSY. Request again after that request finishes.
Issuance hours
Outside the request hours, the API returns
409 OUTSIDE_SERVICE_HOURS and reserves no points. Request again during the request hours.
If Hometax does not accept the request, such as during maintenance, the request ends as FAILED and deducts no points. Request again shortly.
Request a document
document.
Bolta-Client-Reference-Id (1 to 255 characters) for each request. If you did not receive a response, resend the same value and body. The API returns the existing request.
The API returns 202 Accepted with the response below.
language is the language of the issued document. It is always KO for documents other than the business registration proof.
Retrieve the result
FAILED and deducts no points.
A corporate registry takes a few minutes, and longer when requests pile up. A corporation registration number that the Internet Registry Office cannot find, a corporation with no active registry because it was dissolved or closed, and an unsupported corporation type end as FAILED and deduct no points. For a corporation with branches or a changed trade name, Bolta issues the head office’s current registry.
A
COMPLETED response fills in these fields.
When the URL expires, retrieve the result again to get a new one. After the retention period,
downloadUrl is null.
The downloaded file is named {document name}_{business registration number}_{issue date}.pdf with the Korean document name, for example 사업자등록증명_123-45-67890_20260919.pdf. An English proof starts with 사업자등록증명(영문)_.... A corporate registry uses the corporation registration number instead of the business registration number: 법인등기열람_110111-1234567_20260922.pdf for a view copy and 법인등기발급_... for a submission copy. Clients that do not support UTF-8 file names get an ASCII name such as business-registration-proof_1234567890_20260919.pdf. The same document downloaded more than once on the same day gets the same file name, so store the file together with its issuanceKey.
Test key
Test keys do not submit to any agency and deduct no points.- Hometax documents always end as
COMPLETEDright away. - A corporate registry gets its result from
corporationNumber. Test keys accept only the numbers below. For any other number, the API returns400 INVALID_REQUEST.
The
COMPLETED result includes a sample PDF URL. The sample is not a real document and has the same content for every document type. The sample URL is valid for 5 minutes, and its issue date is fixed at January 1, 2026. Retrieving again after expiry and the file naming rule work the same as live issuance, so use a test key to check your download integration.
