사업자 프로필 상세 조회

사업자등록번호 한 건의 상세 프로필을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 조회에 성공하면 90포인트를 차감하고, 프로필이 없는 번호(404)는 차감하지 않습니다.

registration과 taxation은 볼타가 마지막으로 확인해 저장한 값입니다. 호출 시점의 상태가 필요하면 사업자등록 상태 조회 API를 쓰세요. 테스트 키는 가이드에 안내한 테스트 번호만 모의 조회합니다. 사업자 프로필 조회 가이드

GET

businessProfiles

{businessRegistrationNumber}

사업자 프로필 상세 조회

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))

}

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"
  }
}

인증

Authorization

string

header

필수

API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.

경로 매개변수

businessRegistrationNumber

string

필수

조회할 사업자등록번호 10자리. 하이픈(-)을 포함해도 됩니다.

응답

조회 성공

사업자 프로필 한 건. 모든 필드를 항상 담고, 값이 없으면 null, 목록은 빈 배열입니다.

businessRegistrationNumber

string

필수

하이픈 없는 10자리 사업자등록번호

corporateRegistrationNumber

string | null

필수

하이픈 없는 13자리 법인등록번호

businessKind

enum<string> | null

필수

사업자 구분. INDIVIDUAL 개인사업자, CORPORATE 법인사업자입니다.

사용 가능한 옵션:

INDIVIDUAL,

CORPORATE,

null

commercialSalesNumber

string | null

필수

통신판매업 신고번호

organizationName

string | null

필수

상호

organizationNameEnglish

string | null

필수

영문 상호

formerOrganizationNames

object[]

필수

이전 상호. 최근에 바뀐 것부터 담습니다.

Show child attributes

representativeName

string | null

필수

대표자명. 원천 자료가 가려서 준 값은 가린 그대로 담습니다.

address

object | null

필수

주소. 원천 자료에 주소가 없으면 null입니다.

Show child attributes

contact

object

필수

연락처. 연락처가 하나도 없어도 객체로 담습니다.

Show child attributes

industry

object

필수

업종. 업종을 몰라도 객체로 담습니다.

Show child attributes

openedOn

string<date> | null

필수

개업일

businessRegisteredOn

string<date> | null

필수

사업자등록일

corporationEstablishedOn

string<date> | null

필수

법인설립일

registration

object | null

필수

볼타가 마지막으로 확인한 사업자 등록 상태. 확인한 적이 없으면 null입니다.

Show child attributes

taxation

object | null

필수

볼타가 마지막으로 확인한 과세 정보. 모르면 null입니다.

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))

}

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"
  }
}

세금계산서 발행

세금계산서 역발행

발급자

인증서

세금계산서 조회

현금영수증

사업자등록 상태 조회

사업자등록증 인식과 진위확인

사업자 프로필 조회

매출/매입 내역 조회

입출금 내역 조회

예금주 조회

서류 발급

사업자 프로필 상세 조회

인증

경로 매개변수

응답