Check Business Registration Statuses in Bulk
Check up to 100 business registration numbers at once. This API requires no issuer registration, no certificate, and no client reference ID. Each number whose status the API returns deducts 10 points, and a number with status: null deducts nothing.
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
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
},
"taxation": {
"type": "GENERAL",
"changedOn": "2026-01-01"
}
}
},
{
"businessRegistrationNumber": "1000000028",
"status": {
"businessRegistrationNumber": "1000000028",
"registration": {
"status": "ACTIVE",
"closedOn": null
},
"taxation": {
"type": "SIMPLIFIED_RECEIPT_ISSUER",
"changedOn": "2026-01-01"
}
}
},
{
"businessRegistrationNumber": "1000000066",
"status": {
"businessRegistrationNumber": "1000000066",
"registration": {
"status": "SUSPENDED",
"closedOn": null
},
"taxation": {
"type": "GENERAL",
"changedOn": "2026-01-01"
}
}
}
]
}Authorizations
Body
Business registration status bulk check request
Business registration numbers to check. Enter between 1 and 100. Only the first occurrence of a duplicate is kept.
1 - 100 elementsTen-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.
^\d{3}-?\d{2}-?\d{5}$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
},
"taxation": {
"type": "GENERAL",
"changedOn": "2026-01-01"
}
}
},
{
"businessRegistrationNumber": "1000000028",
"status": {
"businessRegistrationNumber": "1000000028",
"registration": {
"status": "ACTIVE",
"closedOn": null
},
"taxation": {
"type": "SIMPLIFIED_RECEIPT_ISSUER",
"changedOn": "2026-01-01"
}
}
},
{
"businessRegistrationNumber": "1000000066",
"status": {
"businessRegistrationNumber": "1000000066",
"registration": {
"status": "SUSPENDED",
"closedOn": null
},
"taxation": {
"type": "GENERAL",
"changedOn": "2026-01-01"
}
}
}
]
}