> ## 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 Reverse Issuance Request Status > Retrieves the current status of a reverse issuance request. Use it when you did not receive a webhook or want to check a request the supplier has not approved yet. Test key requests skip supplier approval. A test request canceled with the Cancel Reverse Issuance Request API returns `CANCELED`. See [Email-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-email) | [Simple-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-simple). ## OpenAPI ````yaml /openapi.en.yaml get /v1/taxInvoices/{issuanceKey}/issueRequest 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/taxInvoices/{issuanceKey}/issueRequest: get: tags: - Reverse Issuance summary: Retrieve Reverse Issuance Request Status description: > Retrieves the current status of a reverse issuance request. Use it when you did not receive a webhook or want to check a request the supplier has not approved yet. Test key requests skip supplier approval. A test request canceled with the Cancel Reverse Issuance Request API returns `CANCELED`. See [Email-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-email) | [Simple-approval reverse issuance](/en/docs/api-introduction/usecase-reverse-simple). parameters: - name: issuanceKey in: path description: The issuance key returned by the reverse issuance request required: true schema: type: string responses: '200': description: Lookup succeeded content: application/json: schema: $ref: '#/components/schemas/TaxInvoiceIssueRequestStatusResponse' examples: Waiting for supplier approval: x-parity-id: requested summary: A request delivered to the supplier and waiting for approval value: issuanceKey: 8D529FAD3EBAE050B79CE943CCC7CEDE status: REQUESTED approvalDueDate: '2026-10-12' failure: null Approval deadline passed: x-parity-id: expired summary: A request the supplier did not approve by the deadline value: issuanceKey: 8D529FAD3EBAE050B79CE943CCC7CEDE status: EXPIRED approvalDueDate: '2026-10-12' failure: null Issuance failed: x-parity-id: issuance-failed summary: A request the supplier approved but that failed to issue value: issuanceKey: 8D529FAD3EBAE050B79CE943CCC7CEDE status: FAILED approvalDueDate: '2026-10-12' failure: stage: ISSUANCE code: NOT_FOUND_CERTIFICATE message: 공동인증서가 등록되지 않았습니다. Submission failed: x-parity-id: submission-failed summary: >- A request that failed at submission and never reached the supplier value: issuanceKey: 8D529FAD3EBAE050B79CE943CCC7CEDE status: FAILED approvalDueDate: null failure: stage: SUBMISSION code: SUBMISSION_FAILED message: >- 요청이 접수 단계에서 실패해 공급자에게 전달되지 않았습니다. 같은 clientReferenceId 로는 다시 요청할 수 없습니다. 새 clientReferenceId 로 요청해주세요. headers: {} '400': description: >- The `issuanceKey` is not a reverse issuance request. 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. '403': description: >- The request belongs to a different API key or issuer. The response `code` is `FORBIDDEN`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: >- The `issuanceKey` does not exist. The response `code` is `NOT_FOUND`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: TaxInvoiceIssueRequestStatusResponse: type: object description: Reverse issuance request status lookup result properties: issuanceKey: $ref: '#/components/schemas/IssuanceKey' status: type: string enum: - REQUESTED - APPROVED - ISSUED - REJECTED - CANCELED - EXPIRED - FAILED description: > Reverse issuance request status. `REQUESTED`: Accepted and waiting for supplier approval. Includes the period before Bolta delivers the request to the supplier. `APPROVED`: Approved by the supplier and being sent to the NTS. `ISSUED`: Issued. `REJECTED`: Rejected by the supplier. `CANCELED`: Request canceled. `EXPIRED`: Approval deadline passed. `FAILED`: Submission or issuance failed. Check `failure.stage` for the stage. approvalDueDate: type: - string - 'null' format: date description: >- Supplier approval deadline. `null` when Bolta has not yet delivered the request to the supplier, or when the request ended without being delivered. failure: description: >- Failure reason. Set only when `status` is `FAILED`; otherwise `null`. anyOf: - $ref: '#/components/schemas/TaxInvoiceIssueRequestFailure' - type: 'null' required: - issuanceKey - status - approvalDueDate - failure 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 IssuanceKey: type: string description: >- Issuance request identifier. Its format and length may change, so store the entire string as is. examples: - 8D529FAD3EBAE050B79CE943CCC7CEDE TaxInvoiceIssueRequestFailure: type: object description: Reverse issuance request failure reason properties: stage: type: string enum: - SUBMISSION - ISSUANCE description: > Failure stage. `SUBMISSION`: The request never reached the supplier. Bolta could not accept the request, or rejected it because a business status was ineligible. `ISSUANCE`: The supplier approved, but issuance failed. code: type: string description: >- Error code. `SUBMISSION_FAILED` for a submission failure; otherwise the same value as `data.cause.code` in the issuance failure webhook. `ISSUANCE_FAILED` when the issuance failure reason is unknown. message: type: string description: Error description required: - stage - code - message 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. ````