> ## 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. Issuance usually finishes within 30 seconds, so poll every 5 to 10 seconds. Bolta processes one request at a time for each business. If you send several at once, each request starts after the previous one finishes. When the status is `COMPLETED`, download the original PDF from `downloadUrl`. The 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`. Test keys return a sample PDF URL. [Document issuance guide](/en/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/api-introduction/overview) | [Authentication guide](/en/api-introduction/authentication) | [Use cases](/en/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/api-introduction/issuance-guide) | [Amendment types](/en/api-introduction/amendment-guide) - name: Tax Invoice Retrieval description: Retrieve e-tax invoice results and request processing status. - name: Reverse Issuance description: > Request and manage reverse issuance of e-tax invoices. [Email-approval reverse issuance](/en/api-introduction/usecase-reverse-email) | [Simple-approval reverse issuance](/en/api-introduction/usecase-reverse-simple) - name: Cash Receipt description: > Issue, cancel, and check the status of cash receipts. Check the final result via webhook or the status API. [Cash receipt guide](/en/api-introduction/cash-receipt-guide) | [Cash receipt webhooks](/en/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/api-introduction/business-registration-status) - 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/api-introduction/bank-account-transactions) - name: Document Issuance description: > Issue National Tax Service certificates from Hometax and download the original PDF. You can issue documents only for the business that owns the API key, and you must register a joint certificate in the Bolta dashboard. Each document deducts 500 points. [Document issuance guide](/en/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/api-introduction/glossary) | [Delegated issuance](/en/api-introduction/usecase-delegated) | [Brokered Tax Invoice Issuance](/en/api-introduction/usecase-brokered) - name: Certificate description: > Register and manage issuer certificates. [Certificate registration](/en/api-introduction/certificate-registration) paths: /v1/documentIssuances/{issuanceKey}: get: tags: - Document Issuance summary: Retrieve Document Issuance description: > Retrieve the status of an issuance request. Issuance usually finishes within 30 seconds, so poll every 5 to 10 seconds. Bolta processes one request at a time for each business. If you send several at once, each request starts after the previous one finishes. When the status is `COMPLETED`, download the original PDF from `downloadUrl`. The 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`. Test keys return a sample PDF URL. [Document issuance guide](/en/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`. 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. 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. Filled only when `COMPLETED` and within the retention period. For test keys, a sample PDF URL. 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 DocumentIssuanceLanguage: type: string description: Document language enum: - KO - EN DocumentIssuanceStatus: type: string description: > 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` enum: - ACCEPTED - SUBMITTED - COMPLETED - FAILED - ACTION_REQUIRED securitySchemes: basicAuth: type: http scheme: basic description: >- Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty. ````