사업자등록상태조회

1. CheckCorpNum - 단건 조회

GET https://popbill-test.linkhub.co.kr/CloseDown

GET https://popbill.linkhub.co.kr/CloseDown

사업자번호 1건에 대해 실시간으로 사업자등록상태를 확인합니다.
팝빌 서비스의 안정적인 제공을 위하여 동시호출이 제한될 수 있습니다.
동시에 100건 이상 요청하는 경우 대량 조회를 이용하시는 것을 권장합니다.

Request

요청 헤더

변수명	필수	설명
Authorization	Y	인증 토큰 [참고] 인증 및 헤더 설정
Accept-Language	N	응답 언어 설정 ko-KR: 기본값 en-US
Accept-Encoding	N	응답 압축 방식 gzip
X-PB-UserID	N	팝빌회원 아이디

Query 파라미터

순번	변수명	타입	길이	필수	설명
	CN	string	-	Y	조회할 사업자번호

요청 예시

curl --request GET \
  --url 'https://{domain}/CloseDown?CN={CN}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
corpNum	string	10	조회한 사업자번호
taxType	string	2	사업자 과세유형 null확인실패 10일반과세자 20면세과세자 30간이과세자 31간이과세자 세금계산서 발급사업자 40비영리법인 또는 국가기관, 고유번호가 할당된 단체
typeDate	string	10	과세유형 전환일자 형식 : yyyy-MM-dd
state	string	1	휴폐업상태 null확인실패 0미등록 - 등록되지 않은 사업자번호 1사업중 2폐업 3휴업
stateDate	string	10	휴폐업일자 형식 : yyyyMMdd
checkDate	string	10	국세청 확인일자 형식 : yyyy-MM-dd

응답 예시

{
    "corpNum": "6798700433",
    "typeDate": null,
    "state": "1",
    "stateDate": null,
    "checkDate": "2025-10-20",
    "taxType": "10"
}

2. CheckCorpNums - 대량 조회

POST https://popbill-test.linkhub.co.kr/CloseDown

POST https://popbill.linkhub.co.kr/CloseDown

다수건의 사업자번호에 대해 실시간으로 사업자등록상태를 확인합니다. (최대 1,000건)