기업정보조회

1. CheckBizInfo - 단건 조회

테스트(Sandbox) 운영(Production)

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

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

Request

요청 헤더

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

Query 파라미터

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

요청 예시

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

Response

응답 본문

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

응답 예시

{
    "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": "이형국"
}