Check Business Registration Statuses in Bulk

Check up to 100 business registration numbers at once. Each result has the same structure as the single lookup response. This API requires no issuer registration, no certificate, and no client reference ID. The API keeps only the first occurrence of a duplicate number and returns results in request order. A number the API could not check in this request has status: null, so retry only that number after a short wait. If no number can be checked, the API returns 503. A test key returns mock data only for the fixed numbers listed in the guide and rejects the whole request if any other number is included. Business registration status guide

POST

businessRegistrationStatuses:checkBulk

curl --request POST \
  --url https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessRegistrationNumbers": [
    "1000000014",
    "100-00-00028",
    "1000000066"
  ]
}
'

import requests

url = "https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk"

payload = { "businessRegistrationNumbers": ["1000000014", "100-00-00028", "1000000066"] }
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({businessRegistrationNumbers: ['1000000014', '100-00-00028', '1000000066']})
};

fetch('https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk', 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/businessRegistrationStatuses:checkBulk",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'businessRegistrationNumbers' => [
        '1000000014',
        '100-00-00028',
        '1000000066'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk"

	payload := strings.NewReader("{\n  \"businessRegistrationNumbers\": [\n    \"1000000014\",\n    \"100-00-00028\",\n    \"1000000066\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"businessRegistrationNumbers\": [\n    \"1000000014\",\n    \"100-00-00028\",\n    \"1000000066\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"businessRegistrationNumbers\": [\n    \"1000000014\",\n    \"100-00-00028\",\n    \"1000000066\"\n  ]\n}"

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

{
  "results": [
    {
      "businessRegistrationNumber": "1000000014",
      "status": {
        "businessRegistrationNumber": "1000000014",
        "registration": {
          "status": "ACTIVE",
          "closedOn": null
        },
        "taxType": "GENERAL"
      }
    },
    {
      "businessRegistrationNumber": "1000000028",
      "status": {
        "businessRegistrationNumber": "1000000028",
        "registration": {
          "status": "ACTIVE",
          "closedOn": null
        },
        "taxType": "SIMPLIFIED"
      }
    },
    {
      "businessRegistrationNumber": "1000000066",
      "status": {
        "businessRegistrationNumber": "1000000066",
        "registration": {
          "status": "SUSPENDED",
          "closedOn": null
        },
        "taxType": 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.

Body

application/json

Business registration status bulk check request

businessRegistrationNumbers

string[]

required

Business registration numbers to check. Enter between 1 and 100. Only the first occurrence of a duplicate is kept.

Required array length: 1 - 100 elements

Ten-digit business registration number to check. Hyphens are allowed. The response returns ten digits with hyphens removed. The examples are test-key-only fixed numbers.

Pattern: ^\d{3}-?\d{2}-?\d{5}$

Response

Lookup succeeded. At least one number was checked.

Business registration status bulk lookup result

results

object[]

required

One item per requested number, in request order after duplicates are removed.

Show child attributes

Check Business Registration Statuses in Bulk

curl --request POST \
  --url https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessRegistrationNumbers": [
    "1000000014",
    "100-00-00028",
    "1000000066"
  ]
}
'

import requests

url = "https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk"

payload = { "businessRegistrationNumbers": ["1000000014", "100-00-00028", "1000000066"] }
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({businessRegistrationNumbers: ['1000000014', '100-00-00028', '1000000066']})
};

fetch('https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk', 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/businessRegistrationStatuses:checkBulk",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'businessRegistrationNumbers' => [
        '1000000014',
        '100-00-00028',
        '1000000066'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk"

	payload := strings.NewReader("{\n  \"businessRegistrationNumbers\": [\n    \"1000000014\",\n    \"100-00-00028\",\n    \"1000000066\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"businessRegistrationNumbers\": [\n    \"1000000014\",\n    \"100-00-00028\",\n    \"1000000066\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/businessRegistrationStatuses:checkBulk")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"businessRegistrationNumbers\": [\n    \"1000000014\",\n    \"100-00-00028\",\n    \"1000000066\"\n  ]\n}"

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

{
  "results": [
    {
      "businessRegistrationNumber": "1000000014",
      "status": {
        "businessRegistrationNumber": "1000000014",
        "registration": {
          "status": "ACTIVE",
          "closedOn": null
        },
        "taxType": "GENERAL"
      }
    },
    {
      "businessRegistrationNumber": "1000000028",
      "status": {
        "businessRegistrationNumber": "1000000028",
        "registration": {
          "status": "ACTIVE",
          "closedOn": null
        },
        "taxType": "SIMPLIFIED"
      }
    },
    {
      "businessRegistrationNumber": "1000000066",
      "status": {
        "businessRegistrationNumber": "1000000066",
        "registration": {
          "status": "SUSPENDED",
          "closedOn": null
        },
        "taxType": null
      }
    }
  ]
}

Tax Invoice Issuance

Reverse Issuance

Issuer

Certificate

Tax Invoice Retrieval

Cash Receipt

Business Registration Status

Check Business Registration Statuses in Bulk

Authorizations

Body

Response