Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Base64-encode your API key and pass it. 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

​
businessRegistrationNumber
string
required

Business registration number of the business that owns the API key. Hyphens are allowed.

Example:

"1234567890"

​
document
object
required

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

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
​
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
  • SUBMITTED: Submitted to Hometax, waiting for the result
  • COMPLETED: Issued
  • FAILED: Issuance failed. No points are deducted. Check the certificate, tax arrears, and filing status, then request again with a new Bolta-Client-Reference-Id
  • 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. 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. Filled only when COMPLETED and within the retention period. For test keys, a sample PDF URL.

​
downloadUrlExpiresAt
string<date-time> | null
required

downloadUrl expiry time (UTC)