Retrieve Reverse Issuance Request Status

Retrieves the current status of a reverse issuance request. A single status tells you whether the request is waiting for supplier approval, approved, issued, rejected, canceled, expired, or failed. Use it when you did not receive a webhook or want to check a request the supplier has not approved yet.

A pending request whose approval deadline (approvalDueDate) has passed returns EXPIRED. When status is FAILED, check failure.stage. SUBMISSION means the request never reached the supplier, and ISSUANCE means the supplier approved but issuance failed.

Test key requests skip supplier approval. A test request canceled with the Cancel Reverse Issuance Request API returns CANCELED.

For details, see Email-approval reverse issuance | Simple-approval reverse issuance.

GET

taxInvoices

{issuanceKey}

issueRequest

Retrieve Reverse Issuance Request Status

curl --request GET \
  --url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
  "status": "REQUESTED",
  "approvalDueDate": "2026-10-12",
  "failure": null
}

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.

Path Parameters

issuanceKey

string

required

The issuance key returned by the reverse issuance request

Response

Lookup succeeded

Reverse issuance request status lookup result

issuanceKey

string

required

An identifier for the issuance request. Note that the format and length may change.

Example:

"8D529FAD3EBAE050B79CE943CCC7CEDE"

status

enum<string>

required

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.

Available options:

REQUESTED,

APPROVED,

ISSUED,

REJECTED,

CANCELED,

EXPIRED,

FAILED

approvalDueDate

string<date> | null

required

Supplier approval deadline. null when Bolta has not yet delivered the request to the supplier, or when the request ended without being delivered.

failure

object | null

required

Failure reason. Set only when status is FAILED; otherwise null.

Show child attributes

Retrieve Reverse Issuance Request Status

curl --request GET \
  --url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
  "status": "REQUESTED",
  "approvalDueDate": "2026-10-12",
  "failure": null
}

Tax Invoice Issuance

Reverse Issuance

Issuer

Certificate

Tax Invoice Retrieval

Cash Receipt

Business Registration Status

Retrieve Reverse Issuance Request Status

Authorizations

Path Parameters

Response