Error Codes

Tax invoice issuance API

Status code	Error code	Message
`400`	`NOT_FOUND_CERTIFICATE`	No certificate is registered.
`400`	`INVALID_TRUSTEE_BUSINESS`	Invalid trustee business registration number.
`400`	`INVALID_SUPPLIER_BUSINESS`	No issuer is registered under the current API key.

Tax invoice issuance webhook

Error code	Message
`INVALID_SUPPLIER_BUSINESS`	The supplier’s business registration number is invalid (unregistered or closed).
`INVALID_SUPPLIED_BUSINESS`	The recipient’s business registration number is invalid.
`INVALID_TRUSTEE_BUSINESS`	The trustee’s business registration number is invalid (unregistered or closed).
`INTERNAL_SERVER_ERROR`	An error occurred on the Bolta server.
`INVALID_CERTIFICATE`	The registered certificate is invalid (expired or revoked).

Issuer registration API

Status code	Error code	Message
`400`	`INVALID_SUPPLIER_BUSINESS`	Invalid business registration number.

Cash receipt API

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	Request validation or cancellation eligibility failed
`401`	-	API key authentication failed. Empty response body
`403`	`FORBIDDEN`	The client does not have access to the issuer
`409`	`IDEMPOTENCY_CONFLICT`	Idempotency conflict, cancellation before issuance processing starts, or duplicate active cancellation
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`SERVICE_UNAVAILABLE`	Internal API communication error during issuance or cancellation

Cash receipt webhook

When cash receipt issuance or cancellation fails, the API includes one of the following codes in data.cause.code in the webhook payload and failure.code in the status response.

Error code	Payload message
`INVALID_ISSUER`	공급자 정보 또는 현금영수증 발행 등록 상태를 확인해주세요.
`INVALID_RECIPIENT_IDENTIFIER`	현금영수증 발급 수단 정보를 확인해주세요.
`ORIGINAL_ISSUANCE_FAILED`	원본 현금영수증 발행이 실패해 취소 요청을 처리할 수 없습니다.
`CANCELLATION_TARGET_NOT_FOUND`	이미 취소되었거나 취소할 수 없는 거래입니다.
`UNKNOWN`	현금영수증 처리에 실패했습니다. 문제가 계속되면 고객센터로 문의해주세요.

ORIGINAL_ISSUANCE_FAILED and CANCELLATION_TARGET_NOT_FOUND are returned only with CASH_RECEIPT_CANCEL_FAILED.

ORIGINAL_ISSUANCE_FAILED: Bolta accepted the cancellation request while the original issuance was in progress, but the original issuance later failed
CANCELLATION_TARGET_NOT_FOUND: The cancellation target could not be found, was already canceled, or already had a cancellation request

Tax invoice issuance deadline API

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	`date` is missing, is not in `YYYY-MM-DD` format or is not a real date, or falls in a month without a supported deadline
`401`	-	API key authentication failed. Empty response body

See Tax Invoice Issuance Deadline for details.

Business registration status API

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	Missing business registration number, input that is not ten digits, or a test key looking up a number outside the documented list. For bulk lookup, an empty array or more than 100 numbers
`400`	`INVALID_BUSINESS_REGISTRATION_NUMBER`	Business registration number with an invalid checksum
`401`	-	API key authentication failed. Empty response body
`402`	`PAYMENT_REQUIRED`	Insufficient balance on a live key
`403`	`FORBIDDEN`	No access to the requested resource
`429`	`RATE_LIMITED`	Partner call quota or Bolta’s service-wide lookup limit exceeded. The `Retry-After` header carries the seconds remaining
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`LOOKUP_UNAVAILABLE`	Cannot check the business registration status. For bulk lookup, no number could be checked
`503`	`SERVICE_UNAVAILABLE`	Temporary internal API communication error

When a bulk lookup cannot check only some numbers, the API returns 200 instead of an error and sets status to null for those items. See Business Registration Status for details.

Revenue and expense API

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	Invalid date format, `from` later than `to`, or an invalid `type` or `limit`
`400`	`INVALID_CURSOR`	Modified or malformed cursor, or the path, filters, or key mode differ from when the cursor was issued
`401`	-	API key authentication failed. Empty response body
`402`	`PLAN_UPGRADE_REQUIRED`	Plan below Standard (not an insufficient point balance)
`409`	`SYNC_IN_PROGRESS`	A collection for the same path is already running
`422`	`NO_SOURCE_CONNECTED`	No revenue or expense connection
`429`	`SYNC_RATE_LIMITED`	Sync request limit exceeded. The `Retry-After` header carries the seconds remaining
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`FEED_UNAVAILABLE`	Records temporarily unavailable. Call again with the same cursor
`503`	`SYNC_UNAVAILABLE`	Temporarily unable to evaluate the sync request
`503`	`SERVICE_UNAVAILABLE`	Temporary internal API communication error

See Revenue and Expense for details.

Bank account transactions API

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	Invalid date format, `from` later than `to`, or an invalid `transactionType` or `limit`
`400`	`INVALID_CURSOR`	Modified or malformed cursor, or filters or API key differ from when the cursor was issued
`401`	-	API key authentication failed. Empty response body
`402`	`PLAN_UPGRADE_REQUIRED`	Plan below Standard (not an insufficient point balance)
`404`	`BANK_ACCOUNT_NOT_FOUND`	`bankAccountId` that does not exist or belongs to another business
`409`	`SYNC_IN_PROGRESS`	A sync is already running
`422`	`BANK_ACCOUNT_NOT_CONNECTED`	No bank account is connected
`429`	`SYNC_RATE_LIMITED`	Sync request limit exceeded. The `Retry-After` header carries the seconds remaining
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`SYNC_UNAVAILABLE`	Temporarily unable to evaluate the sync request
`503`	`SERVICE_UNAVAILABLE`	Temporary internal API communication error

See Bank Account Transactions for details.

Bank account holder API

When a holder lookup fails, a single inquiry returns HTTP 400, while a bulk inquiry returns the item error in results[].error with HTTP 200.

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	Invalid request format, more than 100 accounts, or a test key request outside the fixed account list
`400`	`ACCOUNT_NOT_VERIFIED`	The account could not be verified
`400`	`ACCOUNT_NOT_AVAILABLE`	The virtual account cannot accept deposits
`400`	`AMOUNT_REQUIRED`	The virtual account has a fixed deposit amount but `amount` is missing
`400`	`AMOUNT_MISMATCH`	The `amount` sent differs from the amount fixed on the virtual account
`400`	`AMOUNT_VERIFICATION_UNAVAILABLE`	The fixed-amount virtual account cannot be looked up right now
`400`	`UNSUPPORTED_BANK`	Bank code that does not support account holder lookup
`401`	-	API key authentication failed. Empty response body
`402`	`PAYMENT_REQUIRED`	Insufficient point balance
`403`	`FORBIDDEN`	No access to the requested resource
`409`	`POINT_RESERVED_BY_IN_FLIGHT_REQUESTS`	Balance is short once requests in progress are counted
`429`	`RATE_LIMITED`	Daily lookup limit exceeded. The `Retry-After` header carries the seconds remaining
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`BANK_UNAVAILABLE`	Bank maintenance or a connection error
`503`	`LOOKUP_UNAVAILABLE`	Unable to evaluate the lookup protection limit
`503`	`SERVICE_UNAVAILABLE`	Temporary internal API communication error

See Bank Account Holder for details.

Document issuance API

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	Invalid request format, missing `language` for a business registration proof, invalid corporation registration number, missing `cancelledEntries` for a corporate registry, or a test key request with a corporation registration number outside the list
`400`	`PERIOD_NOT_CLOSED`	The fiscal year of the standard financial statement proof has not ended
`401`	-	API key authentication failed. Empty response body
`402`	`PAYMENT_REQUIRED`	Insufficient point balance
`404`	`DOCUMENT_ISSUANCE_NOT_FOUND`	Unknown `issuanceKey`, or a request accepted under another partner or with a key of the other mode
`409`	`CERTIFICATE_REQUIRED`	Joint certificate not registered or expired. Hometax documents only
`409`	`IDEMPOTENCY_CONFLICT`	Different body for the same `Bolta-Client-Reference-Id`
`409`	`OUTSIDE_SERVICE_HOURS`	Requested outside the document’s request hours
`409`	`TARGET_BUSY`	Another request is issuing the same corporate registry document with the same `cancelledEntries` for the same corporation
`409`	`POINT_RESERVED_BY_IN_FLIGHT_REQUESTS`	Balance is short once requests in progress are counted
`429`	`TOO_MANY_IN_FLIGHT`	Five requests are already in progress
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`DOCUMENT_ISSUANCE_UNAVAILABLE`	Bolta cannot issue the document right now. Request again shortly
`503`	`SERVICE_UNAVAILABLE`	Temporary internal API communication error

See Document Issuance for details.

Tax invoice PDF API

Status code	Error code	Condition
`400`	`TAX_INVOICE_RETRIEVE_NOT_AVAILABLE`	Issuance not finished or failed. For reverse issuance, not yet approved or rejected by the supplier
`400`	`INVALID_DOCUMENT`	The PDF cannot be generated from the document data stored in Bolta
`401`	-	API key authentication failed. Empty response body
`403`	`FORBIDDEN`	Not the API key that requested the issuance
`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
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`PDF_GENERATION_FAILED`	The PDF could not be generated after several attempts
`503`	`SERVICE_UNAVAILABLE`	Temporary internal API communication error

See Tax Invoice PDF for details.

Common errors

Status code	Error code	Message
`400`	`INVALID_REQUEST`	The request could not be processed. This response is returned when a required parameter is missing or a parameter format is invalid. Check your request parameters.
`404`	`NOT_FOUND`	The requested resource does not exist. Double-check the API address you requested.
`500`	`INTERNAL_SERVER_ERROR`	An error occurred on the Bolta server.

API Introduction

API Guides

Use Cases

SDK / No-code

Tax invoice issuance API

Tax invoice issuance webhook

Issuer registration API

Cash receipt API

Cash receipt webhook

Tax invoice issuance deadline API

Business registration status API

Revenue and expense API

Bank account transactions API

Bank account holder API

Document issuance API

Tax invoice PDF API

Common errors

​Tax invoice issuance API

​Tax invoice issuance webhook

​Issuer registration API

​Cash receipt API

​Cash receipt webhook

​Tax invoice issuance deadline API

​Business registration status API

​Revenue and expense API

​Bank account transactions API

​Bank account holder API

​Document issuance API

​Tax invoice PDF API

​Common errors

Tax invoice issuance API

Tax invoice issuance webhook

Issuer registration API

Cash receipt API

Cash receipt webhook

Tax invoice issuance deadline API

Business registration status API

Revenue and expense API

Bank account transactions API

Bank account holder API

Document issuance API

Tax invoice PDF API

Common errors