Skip to main content
Some links point to the service guide, which is currently available in Korean only.

​
API key authentication (Basic Auth)

The Bolta API uses HTTP Basic Authentication. Base64-encode your API key and include it in the Authorization header.
You must append a colon (:) after the API key before Base64-encoding it.
Example

​
Test key vs. live key

Tax invoices issued with a test key are not reported to the National Tax Service (NTS). Always use a test key during development and testing.
For how to issue an API key, see the API key guide.

​
Request headers

​
Supplier-Key

A header that identifies the supplier itself that issues the tax invoice. Pass the supplierKey value obtained from the Register Supplier API.
Each supplierKey is managed independently per API key. A supplierKey created under a test key and one created under a live key are different values and are not interchangeable.
Supplier-Key is the key of the supplier (issuer) itself.The information of the recipient (supplied party) that receives the tax invoice goes in the supplied field of the request body, not in the Supplier-Key header. Be careful not to pass the recipient’s key into Supplier-Key by mistake.

​
Client-Reference-Id

A header that guarantees the idempotency of a request. If you send a duplicate request with the same Client-Reference-Id, the existing result is returned.
If you did not receive a response due to a network error or similar, re-sending with the same ID prevents duplicate issuance.