> ## Documentation Index > Fetch the complete documentation index at: https://docs.bolta.io/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Document Issuance > Retrieve the status of an issuance request. Hometax documents usually finish within 30 seconds, so poll every 5 to 10 seconds. A corporate registry takes a few minutes. If you send several Hometax document requests for the same business, each request starts after the previous one finishes. If the wait exceeds 1 hour, the request changes to `FAILED` and deducts no points. When the status is `COMPLETED`, download the original PDF from `downloadUrl`. The URL is valid for 5 minutes for Hometax documents and 1 minute for a corporate registry. A test key's sample URL is valid for 5 minutes. When it expires, retrieve the result again to get a new one. The file is named `{document name}_{business registration number}_{issue date}.pdf`, and a corporate registry uses the corporation registration number instead. [Document issuance guide](/en/docs/api-introduction/document-issuance) ## OpenAPI ````yaml /openapi.en.yaml get /v1/documentIssuances/{issuanceKey} openapi: 3.1.0 info: title: Bolta API description: > The Bolta e-tax invoice API. [API Overview](/en/docs/api-introduction/overview) | [Authentication guide](/en/docs/api-introduction/authentication) | [Use cases](/en/docs/api-introduction/usecase-b2b) version: 1.0.0 servers: - url: https://xapi.bolta.io description: Bolta API server security: - basicAuth: [] tags: - name: Tax Invoice Issuance description: > Issue and amend e-tax invoices. [Calculating the issuance amount](/en/docs/api-introduction/issuance-guide) | [Amendment types](/en/docs/api-introduction/amendment-guide) - name: Tax Invoice Retrieval description: > Retrieve e-tax invoice results and request processing status, and download the PDF of an issued tax invoice. [Tax invoice PDF guide](/en/docs/api-introduction/tax-invoice-pdf) - name: Reverse Issuance description: > Request and manage reverse issuance of e-tax invoices. [Email-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-email) | [Simple-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-simple) - name: Cash Receipt description: > Issue, cancel, and check the status of cash receipts. [Cash receipt guide](/en/docs/api-introduction/cash-receipt-guide) | [Cash receipt webhooks](/en/docs/api-introduction/webhook-cash-receipt) - name: Business Registration Status description: > Check the registration status and tax type of a business registration number. Look up one number or up to 100 numbers at once. This API requires no issuer registration and no certificate. [Business registration status guide](/en/docs/api-introduction/business-registration-status) - name: Revenue and Expense description: > Retrieve the revenue and expense tax invoices of your own business in Bolta in the order they changed, and request a collection. Responses include documents issued through Bolta and documents collected from Hometax. You need a Standard plan or higher, and the calls deduct no points. Connect Hometax in the Bolta dashboard first. [Revenue and expense guide](/en/docs/api-introduction/revenue-expense) - name: Bank Account Transactions description: > Retrieve the bank accounts and transactions connected to your own business in Bolta, and request a sync. You need a Standard plan or higher, and the calls deduct no points. Connect bank accounts in the Bolta dashboard first. [Bank account transactions guide](/en/docs/api-introduction/bank-account-transactions) - name: Bank Account Holder description: > Look up account holder names with a bank code and an account number. One path takes a single account and the other takes up to 100 accounts at once. Each account that returns a holder name deducts 50 points. [Bank account holder guide](/en/docs/api-introduction/bank-account-holder) - name: Document Issuance description: > Issue National Tax Service certificates from Hometax or a certified copy of corporate registry, and download the original PDF. Hometax documents are issued only for the business that owns the API key, and you must register a joint certificate in the Bolta dashboard. A corporate registry is issued for the corporation in `corporationNumber` and needs no joint certificate. Supported corporation types are stock company, limited company, general partnership company, limited partnership company, limited liability company, incorporated association, incorporated foundation, medical corporation, cooperative (including social cooperative), and other corporate entity (such as a patent corporation). Each document deducts 500 points for Hometax documents, 1,000 points for a corporate registry view copy, and 1,500 points for a submission copy. [Document issuance guide](/en/docs/api-introduction/document-issuance) - name: Issuer description: > Register and manage businesses that act as tax invoice issuers. Certificate requirements depend on the issuance type. [Glossary](/en/docs/api-introduction/glossary) | [Delegated issuance](/en/docs/api-introduction/usecase-delegated) | [Brokered Tax Invoice Issuance](/en/docs/api-introduction/usecase-brokered) - name: Certificate description: > Register and manage issuer certificates. [Certificate registration](/en/docs/api-introduction/certificate-registration) paths: /v1/documentIssuances/{issuanceKey}: get: tags: - Document Issuance summary: Retrieve Document Issuance description: > Retrieve the status of an issuance request. Hometax documents usually finish within 30 seconds, so poll every 5 to 10 seconds. A corporate registry takes a few minutes. If you send several Hometax document requests for the same business, each request starts after the previous one finishes. If the wait exceeds 1 hour, the request changes to `FAILED` and deducts no points. When the status is `COMPLETED`, download the original PDF from `downloadUrl`. The URL is valid for 5 minutes for Hometax documents and 1 minute for a corporate registry. A test key's sample URL is valid for 5 minutes. When it expires, retrieve the result again to get a new one. The file is named `{document name}_{business registration number}_{issue date}.pdf`, and a corporate registry uses the corporation registration number instead. [Document issuance guide](/en/docs/api-introduction/document-issuance) parameters: - name: issuanceKey in: path description: '`issuanceKey` from the issuance request response' required: true schema: type: string format: uuid responses: '200': description: Retrieved content: application/json: schema: $ref: '#/components/schemas/DocumentIssuanceResponse' examples: Completed: x-parity-id: completed summary: Response with a downloadable original PDF value: issuanceKey: 00000000-0000-4000-8000-000000000001 clientReferenceId: order-20260919-001 type: BUSINESS_REGISTRATION_PROOF language: KO status: COMPLETED requestedAt: '2026-09-19T03:00:00Z' issuedOn: '2026-09-19' retentionExpiresAt: '2026-10-19T03:00:30Z' downloadUrl: >- https://example.com/documents/00000000-0000-4000-8000-000000000001.pdf downloadUrlExpiresAt: '2026-09-19T03:05:30Z' Failed: x-parity-id: failed summary: Failed response with no points deducted value: issuanceKey: 00000000-0000-4000-8000-000000000002 clientReferenceId: order-20260919-002 type: TAX_PAYMENT_CERTIFICATE language: KO status: FAILED requestedAt: '2026-09-19T03:00:00Z' issuedOn: null retentionExpiresAt: null downloadUrl: null downloadUrlExpiresAt: null headers: {} '400': description: >- `issuanceKey` has an invalid format. The response `code` is `INVALID_REQUEST`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: API key authentication failed. The response has no body. '404': description: >- Unknown `issuanceKey`, or a request accepted under another partner or with a key of the other mode. The response `code` is `DOCUMENT_ISSUANCE_NOT_FOUND`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: >- Internal server error. The response `code` is `INTERNAL_SERVER_ERROR`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: >- Temporary internal API communication error. The response `code` is `SERVICE_UNAVAILABLE`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: DocumentIssuanceResponse: type: object description: Document issuance request and result properties: issuanceKey: type: string format: uuid description: Issuance request identifier clientReferenceId: type: string description: '`Bolta-Client-Reference-Id` used for the request' type: $ref: '#/components/schemas/DocumentIssuanceType' language: allOf: - $ref: '#/components/schemas/DocumentIssuanceLanguage' description: >- Language of the issued document. Always `KO` for documents other than the business registration proof. status: $ref: '#/components/schemas/DocumentIssuanceStatus' requestedAt: type: string format: date-time description: Time the request was accepted (UTC) issuedOn: type: - string - 'null' format: date description: >- Issue date printed on the original PDF. For a corporate registry, the view or issue date. Filled only when `COMPLETED`. retentionExpiresAt: type: - string - 'null' format: date-time description: >- Retention end time (UTC). 30 days after issuance. Filled only when `COMPLETED`. downloadUrl: type: - string - 'null' format: uri description: >- 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: type: - string - 'null' format: date-time description: '`downloadUrl` expiry time (UTC)' required: - issuanceKey - clientReferenceId - type - language - status - requestedAt - issuedOn - retentionExpiresAt - downloadUrl - downloadUrlExpiresAt ErrorResponse: type: object description: The error response returned when an API request fails properties: code: type: string description: Error type identifier message: type: string description: Error description traceId: type: string description: Request trace identifier required: - code - message - traceId DocumentIssuanceType: type: string description: Document type enum: - BUSINESS_REGISTRATION_PROOF - BUSINESS_REGISTRATION_CERTIFICATE - TAX_PAYMENT_CERTIFICATE - VAT_TAX_BASE_PROOF - STANDARD_FINANCIAL_STATEMENT_PROOF - CORPORATE_REGISTRY_VIEW - CORPORATE_REGISTRY_ISSUANCE DocumentIssuanceLanguage: type: string description: Document language enum: - KO - EN DocumentIssuanceStatus: type: string description: > 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` enum: - ACCEPTED - SUBMITTED - COMPLETED - FAILED - ACTION_REQUIRED securitySchemes: basicAuth: type: http scheme: basic description: >- 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. ````