사업자등록 상태 일괄 조회
사업자등록번호를 한 번에 최대 100개까지 조회합니다. 각 항목의 결과는 단건 조회 응답과 같은 구조입니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다.
중복 번호는 처음 나온 것만 남기고, 요청 순서대로 results에 담습니다. 이번 요청에서 확인하지 못한 번호는 status가 null이니 잠시 후 그 번호만 다시 조회하세요. 한 건도 확인하지 못하면 503을 반환합니다. 테스트 키는 가이드에 안내한 고정 번호만 모의 조회하며, 목록 밖 번호가 하나라도 섞이면 요청 전체를 거절합니다. 사업자등록 상태 조회 가이드
POST
/
v1
/
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
}
}
]
}인증
API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.
본문
application/json
사업자등록 상태 일괄 조회 요청
조회할 사업자등록번호 목록. 1개 이상 100개 이하로 입력하세요. 중복은 처음 나온 것만 남깁니다.
Required array length:
1 - 100 elements조회할 사업자등록번호 10자리. 하이픈(-)을 포함해도 됩니다. 응답은 하이픈을 제거한 10자리로 돌려줍니다. 예시는 테스트 키 전용 고정 번호입니다.
Pattern:
^\d{3}-?\d{2}-?\d{5}$응답
조회 성공. 한 건 이상 확인했습니다.
사업자등록 상태 일괄 조회 결과
요청한 번호마다 항목 하나. 중복을 줄인 뒤 요청 순서를 따릅니다.
Show child attributes
Show child attributes
사업자등록 상태 일괄 조회
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
}
}
]
}