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
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
Headers
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.
1 - 255\SBody
Response
Accepted
Document issuance request and result
Issuance status
ACCEPTED: Accepted, not yet submitted to the agencySUBMITTED: Submitted to the agency, waiting for the resultCOMPLETED: IssuedFAILED: 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 newBolta-Client-Reference-Idwhen you request againACTION_REQUIRED: Bolta is checking the result. Do not request the same document again; wait until it changes toCOMPLETEDorFAILED
ACCEPTED, SUBMITTED, COMPLETED, FAILED, ACTION_REQUIRED 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>"
}