사업자등록 상태 단건 조회
사업자등록번호 한 건의 등록 상태와 과세유형을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 상태를 확인하면 10포인트를 차감합니다. 테스트 키는 가이드에 안내한 고정 번호만 모의 조회합니다. 여러 번호를 한 번에 조회하려면 일괄 조회 API를 쓰세요. 사업자등록 상태 조회 가이드
POST
/
v1
/
businessRegistrationStatuses:check
curl --request POST \
--url https://xapi.bolta.io/v1/businessRegistrationStatuses:check \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"businessRegistrationNumber": "1000000014"
}
'{
"businessRegistrationNumber": "1000000014",
"registration": {
"status": "ACTIVE",
"closedOn": null
},
"taxation": {
"type": "GENERAL",
"changedOn": "2026-01-01"
}
}인증
API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.
본문
application/json
사업자등록 상태 조회 요청
조회할 사업자등록번호 10자리. 하이픈(-)을 포함해도 됩니다. 응답은 하이픈을 제거한 10자리로 돌려줍니다. 예시는 테스트 키 전용 고정 번호입니다.
Pattern:
^\d{3}-?\d{2}-?\d{5}$예시:
"1000000014"
"100-00-00014"
응답
조회 성공
curl --request POST \
--url https://xapi.bolta.io/v1/businessRegistrationStatuses:check \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"businessRegistrationNumber": "1000000014"
}
'{
"businessRegistrationNumber": "1000000014",
"registration": {
"status": "ACTIVE",
"closedOn": null
},
"taxation": {
"type": "GENERAL",
"changedOn": "2026-01-01"
}
}