기업정보조회

1. CheckBizInfo - 단건 조회

GET https://popbill-test.linkhub.co.kr/BizInfo/Check

GET https://popbill.linkhub.co.kr/BizInfo/Check

사업자번호 1건에 대한 기업정보를 확인합니다.

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}/BizInfo/Check?CN={CN}' \
  --header 'Authorization: Bearer {token}'

Response

응답 본문

변수명	타입	길이	설명
corpNum	string	10	사업자번호
companyRegNum	string	13	법인등록번호
checkDT	string	14	기업정보조회일시 형식 : yyyyMMddHHmmss
corpName	string	256	상호
ceoname	string	128	대표자명
corpCode	number	3	기업형태코드 100일반회사 101신설회사 102외감 103피합병 110거래소(상장) 111거래소(관리) 112코스닥(등록) 113코스닥(관리) 114코넥스 200폐업 201부도 300휴업 900미정의 999기타
corpScaleCode	number	2	기업규모코드 10대기업 11대기업(금융) 20중견기업 21중견기업(하) 30중소기업 90기타(비영리법인) 99기타
personCorpCode	number	2	개인/법인코드 1법인 2개인 99기타
headOfficeCode	number	2	본점/지점코드 1본점 2지점 99기타
industryCode	string	6	산업코드 한국표준산업분류(10차) 기준
establishDate	string	8	설립일자 형식 : yyyyMMdd
establishCode	number	2	설립코드 1주식 2합자 3합명 4유한 5조합 6정부투자기관 7개인 8학교 9병원 10단체 또는 협회 11미정의 99기타
workPlaceCode	number	2	사업장코드 10본사 20공장 30서울사무소 31사무소 32영업소 33지점 34출장소 40연구소 50건설공장 60창고 99기타
addrCode	string	2	주소유형코드 1도로명 2지번 3입력(입수) 99기타
zipCode	string	6	우편번호
addr	string	256	주소
addrDetail	string	256	상세주소
enAddr	string	256	영문주소
bizClass	string	4096	업종
bizType	string	4096	업태
result	number	3	상태코드 [참고] 팝빌 상태코드
resultMessage	string	4096	상태메시지
closeDownState	number	1	휴폐업상태 0미등록 1사업중 2폐업 3휴업 9확인실패
closeDownStateDate	string	8	휴폐업일자 형식 : yyyyMMdd
closeDownTaxType	number	2	과세유형 null미등록 10일반과세자 20면세과세자 30간이과세자 31간이과세자 세금계산서 발급사업자 40비영리법인 또는 국가기관, 고유번호가 할당된 단체 99확인실패
closeDownTaxTypeDate	string	8	과세유형 전환일자 형식 : yyyy-MM-dd

응답 예시

{
    "corpNum": "6798700433",
    "checkDT": "20251020172533",
    "corpName": "(주)링크허브",
    "corpCode": 100,
    "corpScaleCode": 30,
    "personCorpCode": 1,
    "headOfficeCode": 1,
    "industryCode": "58222",
    "companyRegNum": "2001110471379",
    "establishDate": "20160905",
    "establishCode": 1,
    "workPlaceCode": 10,
    "addrCode": 1,
    "zipCode": "61273",
    "addr": "광주 북구 하남대로 705",
    "addrDetail": "4층 (동림동,엘에스빌딩)",
    "enAddr": "705 Hanam-daero Buk-gu Gwangju",
    "bizClass": "문자재판매/소프트웨어 개발 및 공급/인터넷자료제공/통신판매업",
    "bizType": "도.소매/서비스/정보통신업",
    "result": 100,
    "resultMessage": "성공",
    "closeDownTaxType": 10,
    "closeDownTaxTypeDate": null,
    "closeDownState": 1,
    "closeDownStateDate": null,
    "ceoname": "이형국"
}