Request Document Issuance

Accept a document issuance request. The API returns 202 Accepted with issuanceKey, and issuance runs asynchronously. Retrieve the result with issuanceKey.

Test keys do not submit to any agency and deduct no points. Hometax documents always end as COMPLETED right away. For a corporate registry, corporationNumber 1100000000014 ends as COMPLETED and 1100000000071 as FAILED right away, and any other number returns 400 INVALID_REQUEST. A COMPLETED result includes a sample PDF URL. Document issuance guide

POST

documentIssuances

curl --request POST \
  --url https://xapi.bolta.io/v1/documentIssuances \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "document": {
    "type": "BUSINESS_REGISTRATION_PROOF",
    "language": "KO"
  }
}
'

{
  "issuanceKey": "00000000-0000-4000-8000-000000000001",
  "clientReferenceId": "order-20260919-001",
  "type": "BUSINESS_REGISTRATION_PROOF",
  "language": "KO",
  "status": "ACCEPTED",
  "requestedAt": "2026-09-19T03:00:00Z",
  "issuedOn": null,
  "retentionExpiresAt": null,
  "downloadUrl": null,
  "downloadUrlExpiresAt": 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>"
}

Authorizations

Authorization

string

header

required

Append a colon to your API key, Base64-encode it, and put it in the header. Enter the API key as the username and leave the password empty.

Headers

Bolta-Client-Reference-Id

string

required

Enter a client reference ID of 1 to 255 characters. When you resend the same value with the same body, the API returns the existing request. When you send the same value with a different body, the API returns 409 Conflict with IDEMPOTENCY_CONFLICT.

Required string length: 1 - 255

Pattern: \S

Body

application/json

Document issuance request

document

object

required

Document to issue. Fill in the input that matches type.

Show child attributes

Response

Accepted

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,

CORPORATE_REGISTRY_VIEW,

CORPORATE_REGISTRY_ISSUANCE

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, not yet submitted to the agency
SUBMITTED: Submitted to the agency, waiting for the result
COMPLETED: Issued
FAILED: Issuance failed. No points are deducted. For Hometax documents, check the certificate, tax arrears, and filing status. For a corporate registry, check the corporation registration number and the corporation's type and status. If nothing is wrong, request again shortly. Use a new Bolta-Client-Reference-Id when you request again
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. For a corporate registry, the view or issue date. 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 for Hometax documents and 1 minute for a corporate registry. Filled only when COMPLETED and within the retention period. For test keys, a sample PDF URL valid for 5 minutes for every document type.

downloadUrlExpiresAt

string<date-time> | null

required

downloadUrl expiry time (UTC)

curl --request POST \
  --url https://xapi.bolta.io/v1/documentIssuances \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "document": {
    "type": "BUSINESS_REGISTRATION_PROOF",
    "language": "KO"
  }
}
'

{
  "issuanceKey": "00000000-0000-4000-8000-000000000001",
  "clientReferenceId": "order-20260919-001",
  "type": "BUSINESS_REGISTRATION_PROOF",
  "language": "KO",
  "status": "ACCEPTED",
  "requestedAt": "2026-09-19T03:00:00Z",
  "issuedOn": null,
  "retentionExpiresAt": null,
  "downloadUrl": null,
  "downloadUrlExpiresAt": 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>"
}

Tax Invoice Issuance

Reverse Issuance

Issuer

Certificate

Tax Invoice Retrieval

Cash Receipt

Business Registration Status

Revenue and Expense

Bank Account Transactions

Bank Account Holder

Document Issuance

Request Document Issuance

Authorizations

Headers

Body

Response