사업자 프로필 검색
상호, 대표자명, 사업자등록번호로 사업자를 검색합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 돌려준 결과 한 건마다 9포인트를 차감하고, 결과가 없으면 차감하지 않습니다.
hasMore가 true이면 nextCursor를 cursor에 넣어 이어 받으세요. 받은 결과가 limit보다 적어도 hasMore가 true일 수 있으니 hasMore를 보고 이어 호출하세요. 한 검색어로 앞 1,000건까지 받을 수 있습니다. 테스트 키는 가이드에 안내한 모의 사업자에서만 찾습니다. 사업자 프로필 조회 가이드
curl --request GET \
--url https://xapi.bolta.io/v1/businessProfiles:search \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/businessProfiles:search"
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:search', 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:search",
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:search"
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:search")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/businessProfiles:search")
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{
"items": [
{
"businessRegistrationNumber": "1000000014",
"organizationName": "테스트상사 주식회사",
"representativeName": "김*타",
"registration": {
"status": "ACTIVE"
},
"region": "서울특별시 강남구"
},
{
"businessRegistrationNumber": "1000000028",
"organizationName": "테스트상사 간이점",
"representativeName": "이*스",
"registration": {
"status": "ACTIVE"
},
"region": "서울특별시 마포구"
},
{
"businessRegistrationNumber": "1000000106",
"organizationName": "테스트상사 세금계산서점",
"representativeName": "박*의",
"registration": {
"status": "ACTIVE"
},
"region": "부산광역시 해운대구"
}
],
"nextCursor": "djE6MDotOjM6MzFmN2UxZGI0NjJkMzVhMQ",
"hasMore": true
}인증
API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.
쿼리 매개변수
검색어. 상호, 이전 상호, 영문 상호, 대표자명, 상호 초성 3자 이상, 사업자등록번호 10자리로 찾습니다. 앞뒤 공백을 뺀 100자 이하, 공백과 기호를 뺀 2글자 이상으로 입력하세요. 사업자등록번호로 찾으면 그 사업자 한 건을 돌려줍니다.
한 번에 받을 결과 수. 한 번에 차감하는 포인트는 최대 limit × 9포인트입니다.
1 <= x <= 50이전 응답의 nextCursor. 받은 값을 그대로 보내세요. cursor는 받을 때의 keyword, excludeStatuses, 키 모드(테스트, 라이브)에 묶입니다. 조건이나 키 모드를 바꿨다면 cursor 없이 처음부터 다시 검색하세요.
결과에서 뺄 사업자 등록 상태. 쉼표로 구분하세요. 휴업이나 폐업으로 확인된 사업자를 빼고, 볼타가 상태를 확인하지 않은 사업자는 남깁니다.
1SUSPENDED, CLOSED curl --request GET \
--url https://xapi.bolta.io/v1/businessProfiles:search \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/businessProfiles:search"
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:search', 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:search",
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:search"
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:search")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/businessProfiles:search")
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{
"items": [
{
"businessRegistrationNumber": "1000000014",
"organizationName": "테스트상사 주식회사",
"representativeName": "김*타",
"registration": {
"status": "ACTIVE"
},
"region": "서울특별시 강남구"
},
{
"businessRegistrationNumber": "1000000028",
"organizationName": "테스트상사 간이점",
"representativeName": "이*스",
"registration": {
"status": "ACTIVE"
},
"region": "서울특별시 마포구"
},
{
"businessRegistrationNumber": "1000000106",
"organizationName": "테스트상사 세금계산서점",
"representativeName": "박*의",
"registration": {
"status": "ACTIVE"
},
"region": "부산광역시 해운대구"
}
],
"nextCursor": "djE6MDotOjM6MzFmN2UxZGI0NjJkMzVhMQ",
"hasMore": true
}