Retrieve Business Profile
Retrieve the detailed profile of one business registration number. This API requires no issuer registration, no certificate, and no client reference id. A successful retrieval deducts 90 points, and a number with no profile (404) deducts nothing.
registration and taxation hold the values Bolta last checked and stored. When you need the state at call time, use the Business Registration Status API. A test key returns mock results only for the test numbers listed in the guide. Business profile guide
curl --request GET \
--url https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber}"
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/businessProfiles/{businessRegistrationNumber}', 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/businessProfiles/{businessRegistrationNumber}",
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/businessProfiles/{businessRegistrationNumber}"
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))
}HttpResponse<String> response = Unirest.get("https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber}")
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{
"businessRegistrationNumber": "1000000014",
"corporateRegistrationNumber": "1101110000006",
"businessKind": "CORPORATE",
"commercialSalesNumber": "2021-서울강남-01234",
"organizationName": "테스트상사 주식회사",
"organizationNameEnglish": "Test Sangsa Co., Ltd.",
"formerOrganizationNames": [
{
"name": "주식회사 테스트랩스",
"changedOn": "2022-03-01"
}
],
"representativeName": "김볼타",
"address": {
"roadAddress": "서울특별시 강남구 가상로 1",
"postalCode": "06236",
"sidoCode": "11",
"sigunguCode": "11680"
},
"contact": {
"phone": "02-000-0000",
"email": "hello@example.com",
"websites": [
"https://example.com"
]
},
"industry": {
"businessType": "서비스업",
"businessItem": "응용 소프트웨어 개발",
"standardIndustry": {
"code": "58222",
"name": "응용 소프트웨어 개발 및 공급업"
},
"category": {
"code": "J",
"name": "정보통신업"
}
},
"openedOn": "2021-03-02",
"businessRegisteredOn": "2021-03-02",
"corporationEstablishedOn": "2021-02-25",
"registration": {
"status": "ACTIVE",
"closedOn": null,
"checkedAt": "2025-12-31T15:00:00Z"
},
"taxation": {
"type": "GENERAL"
}
}Authorizations
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.
Path Parameters
Ten-digit business registration number to retrieve. Hyphens are allowed.
Response
Retrieval succeeded
One business profile. The response always contains every field. A missing value is null, and a list is empty.
Ten-digit business registration number without hyphens
Thirteen-digit corporation registration number without hyphens
Business kind. INDIVIDUAL sole proprietor, CORPORATE corporation.
INDIVIDUAL, CORPORATE, null Mail-order business report number
Business name
English business name
Former business names, most recently changed first.
Show child attributes
Show child attributes
Representative name. A value the source masked stays masked.
Address. null when the source has no address.
Show child attributes
Show child attributes
Contact details. The response holds this object even when there are no contact details.
Show child attributes
Show child attributes
Industry. The response holds this object even when the industry is unknown.
Show child attributes
Show child attributes
Opening date
Business registration date
Corporation establishment date
Business registration state Bolta last checked. null if Bolta has never checked it.
Show child attributes
Show child attributes
Taxation information Bolta last checked. null when unknown.
Show child attributes
Show child attributes
curl --request GET \
--url https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber} \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber}"
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/businessProfiles/{businessRegistrationNumber}', 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/businessProfiles/{businessRegistrationNumber}",
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/businessProfiles/{businessRegistrationNumber}"
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))
}HttpResponse<String> response = Unirest.get("https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber}")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/businessProfiles/{businessRegistrationNumber}")
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{
"businessRegistrationNumber": "1000000014",
"corporateRegistrationNumber": "1101110000006",
"businessKind": "CORPORATE",
"commercialSalesNumber": "2021-서울강남-01234",
"organizationName": "테스트상사 주식회사",
"organizationNameEnglish": "Test Sangsa Co., Ltd.",
"formerOrganizationNames": [
{
"name": "주식회사 테스트랩스",
"changedOn": "2022-03-01"
}
],
"representativeName": "김볼타",
"address": {
"roadAddress": "서울특별시 강남구 가상로 1",
"postalCode": "06236",
"sidoCode": "11",
"sigunguCode": "11680"
},
"contact": {
"phone": "02-000-0000",
"email": "hello@example.com",
"websites": [
"https://example.com"
]
},
"industry": {
"businessType": "서비스업",
"businessItem": "응용 소프트웨어 개발",
"standardIndustry": {
"code": "58222",
"name": "응용 소프트웨어 개발 및 공급업"
},
"category": {
"code": "J",
"name": "정보통신업"
}
},
"openedOn": "2021-03-02",
"businessRegisteredOn": "2021-03-02",
"corporationEstablishedOn": "2021-02-25",
"registration": {
"status": "ACTIVE",
"closedOn": null,
"checkedAt": "2025-12-31T15:00:00Z"
},
"taxation": {
"type": "GENERAL"
}
}