# 사업자 정보 조회 사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/biz_detail 응답 필드 - `data` (object): 조회 데이터 - `data.회사명` (string): 회사명 - `data.사업자등록번호` (string): 사업자등록번호 - `data.법인등록번호` (string): 법인등록번호 - `data.통신판매업번호` (string): 통신판매업번호 - `data.사업자상태` (string): 사업자상태 - 계속사업자 - 휴업자 - 폐업자 - 국세청에 등록되지 않은 사업자입니다 - `data.과세유형` (string): 과세유형 - 부가가치세 일반과세자 - 부가가치세 간이과세자 - 부가가치세 과세특례자 - 부가가치세 면세사업자 - 수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등 - 고유번호가 부여된 단체 - 부가가치세 간이과세자(세금계산서 발급사업자) - `data.폐업일` (string): 폐업일 - `data.대표명` (string): 대표명 - `data.설립일` (string): 설립일 - `data.업종` (string): 업종 - `data.업태` (string): 업태 - `data.종목` (string): 종목 - `data.전화번호` (string): 전화번호 - `data.우편번호` (string): 우편번호 - `data.지번주소` (string): 지번주소 - `data.도로명주소` (string): 도로명주소 - `data.위도` (string): 위도 (좌표를 확보하지 못하면 빈 문자열) - `data.경도` (string): 경도 (좌표를 확보하지 못하면 빈 문자열) - `data.직원수` (string): 직원수 - `data.사업자상태코드` (string): 상태코드01: 계속사업자02: 휴업자03: 폐업자국세청 상태 조회 결과가 있을 때만 포함 - `data.과세유형코드` (string): 과세유형 코드(국세청 분류). 상세 문구는 과세유형 필드 참고예: 01 일반과세자 등국세청 상태 조회 결과가 있을 때만 포함 - `data.법인등록번호_공정위` (string): 법인등록번호 (마스킹 없음)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_운영상태` (string): 통신판매업 운영상태정상영업휴업폐업통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_법인명` (string): 통신판매업 신고 법인명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_인허가번호` (string): 통신판매업 인허가번호통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_신고기관` (string): 신고기관명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_시도` (string): 신고 시·도명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_소재지주소` (string): 소재지 주소 (지번)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_도로명주소` (string): 소재지 도로명주소통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_대표자명` (string): 통신판매업 대표자명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_대표자이메일` (string): 대표자 이메일통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_신고일자` (string): 통신판매업 신고일자 (YYYY-MM-DD)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.success` (integer): 과금 여부0: 실패1: 성공3: 실패(timeout) - `data.국세청관리 업종코드` (string): 국세청관리 업종코드 - `data.표준산업분류(노동부) 업종코드` (string): 표준산업분류(노동부) 업종코드 - `data.팩스번호` (string): 팩스번호 - `data.갱신일` (string): 갱신일 - `data.최초등록일` (string): 최초등록일 - `data.단위과세전환폐업여부` (string): 단위과세전환폐업여부국세청 상태 조회 결과에 해당 값이 있을 때만 포함 - `data.과세유형전환일` (string): 과세유형 전환일 (YYYY-MM-DD)국세청 상태 조회 결과에 해당 값이 있을 때만 포함 - `data.세금계산서적용일` (string): 세금계산서 적용일 (YYYY-MM-DD)국세청 상태 조회 결과에 해당 값이 있을 때만 포함 - `data.직전과세유형` (string): 직전 과세유형국세청 상태 조회 결과에 해당 값이 있을 때만 포함(해당없음 제외) - `data.통판_처리부서` (string): 신고 처리부서명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `data.통판_관리부서전화` (string): 신고 관리부서 전화번호통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): API 호출 요금 - `api.ms` (integer): API 응답 시간 - `api.pl_id` (integer): API 결제 로그 ID ## API 요청: POST /rest/biz_detail ### 입력 - `biz_no` (string, 필수): 사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 4398700761) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "회사명": { "type": "string", "description": "회사명" }, "사업자등록번호": { "type": "string", "description": "사업자등록번호" }, "법인등록번호": { "type": "string", "description": "법인등록번호" }, "통신판매업번호": { "type": "string", "description": "통신판매업번호" }, "사업자상태": { "type": "string", "description": "사업자상태 - 계속사업자 - 휴업자 - 폐업자 - 국세청에 등록되지 않은 사업자입니다" }, "과세유형": { "type": "string", "description": "과세유형 - 부가가치세 일반과세자 - 부가가치세 간이과세자 - 부가가치세 과세특례자 - 부가가치세 면세사업자 - 수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등 - 고유번호가 부여된 단체 - 부가가치세 간이과세자(세금계산서 발급사업자)" }, "폐업일": { "type": "string", "description": "폐업일" }, "대표명": { "type": "string", "description": "대표명" }, "설립일": { "type": "string", "description": "설립일" }, "업종": { "type": "string", "description": "업종" }, "업태": { "type": "string", "description": "업태" }, "종목": { "type": "string", "description": "종목" }, "전화번호": { "type": "string", "description": "전화번호" }, "우편번호": { "type": "string", "description": "우편번호" }, "지번주소": { "type": "string", "description": "지번주소" }, "도로명주소": { "type": "string", "description": "도로명주소" }, "위도": { "type": "string", "description": "위도 (좌표를 확보하지 못하면 빈 문자열)" }, "경도": { "type": "string", "description": "경도 (좌표를 확보하지 못하면 빈 문자열)" }, "직원수": { "type": "string", "description": "직원수" }, "사업자상태코드": { "type": "string", "description": "상태코드01: 계속사업자02: 휴업자03: 폐업자국세청 상태 조회 결과가 있을 때만 포함" }, "과세유형코드": { "type": "string", "description": "과세유형 코드(국세청 분류). 상세 문구는 과세유형 필드 참고예: 01 일반과세자 등국세청 상태 조회 결과가 있을 때만 포함" }, "법인등록번호_공정위": { "type": "string", "description": "법인등록번호 (마스킹 없음)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_운영상태": { "type": "string", "description": "통신판매업 운영상태정상영업휴업폐업통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_법인명": { "type": "string", "description": "통신판매업 신고 법인명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_인허가번호": { "type": "string", "description": "통신판매업 인허가번호통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_신고기관": { "type": "string", "description": "신고기관명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_시도": { "type": "string", "description": "신고 시·도명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_소재지주소": { "type": "string", "description": "소재지 주소 (지번)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_도로명주소": { "type": "string", "description": "소재지 도로명주소통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_대표자명": { "type": "string", "description": "통신판매업 대표자명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_대표자이메일": { "type": "string", "description": "대표자 이메일통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_신고일자": { "type": "string", "description": "통신판매업 신고일자 (YYYY-MM-DD)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "success": { "type": "integer", "description": "과금 여부0: 실패1: 성공3: 실패(timeout)" }, "국세청관리 업종코드": { "type": "string", "description": "국세청관리 업종코드" }, "표준산업분류(노동부) 업종코드": { "type": "string", "description": "표준산업분류(노동부) 업종코드" }, "팩스번호": { "type": "string", "description": "팩스번호" }, "갱신일": { "type": "string", "description": "갱신일" }, "최초등록일": { "type": "string", "description": "최초등록일" }, "단위과세전환폐업여부": { "type": "string", "description": "단위과세전환폐업여부국세청 상태 조회 결과에 해당 값이 있을 때만 포함" }, "과세유형전환일": { "type": "string", "description": "과세유형 전환일 (YYYY-MM-DD)국세청 상태 조회 결과에 해당 값이 있을 때만 포함" }, "세금계산서적용일": { "type": "string", "description": "세금계산서 적용일 (YYYY-MM-DD)국세청 상태 조회 결과에 해당 값이 있을 때만 포함" }, "직전과세유형": { "type": "string", "description": "직전 과세유형국세청 상태 조회 결과에 해당 값이 있을 때만 포함(해당없음 제외)" }, "통판_처리부서": { "type": "string", "description": "신고 처리부서명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" }, "통판_관리부서전화": { "type": "string", "description": "신고 관리부서 전화번호통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함" } }, "description": "조회 데이터" }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "API 호출 요금" }, "ms": { "type": "integer", "description": "API 응답 시간" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "회사명": "주식회사 에이픽", "사업자등록번호": "4398700761", "법인등록번호": "135811-0317959", "통신판매업번호": "2024-서울금천-0123", "사업자상태": "계속사업자", "과세유형": "부가가치세 일반과세자", "폐업일": "", "대표명": "김찬우", "설립일": "2017-06-07", "업종": "정보통신업", "업태": "시스템 소프트웨어 개발 및 공급업", "종목": "", "전화번호": "02-1234-5678", "우편번호": "08505", "지번주소": "서울특별시 금천구 가산동 371-49", "도로명주소": "서울특별시 금천구 가산디지털2로 101, 15층(가산동)", "위도": "", "경도": "", "직원수": "12", "사업자상태코드": "01", "과세유형코드": "01", "법인등록번호_공정위": "135811-0317959", "통판_운영상태": "정상영업", "통판_법인명": "코드라인주식회사", "통판_인허가번호": "2024-서울금천-0101", "통판_신고기관": "서울특별시 금천구", "통판_시도": "서울특별시", "통판_소재지주소": "서울특별시 금천구 가산동 371-49 번지", "통판_도로명주소": "서울특별시 금천구 가산디지털2로", "통판_대표자명": "김찬우", "통판_대표자이메일": "info@example.com", "통판_신고일자": "2024-01-15", "success": 1 }, "api": { "success": true, "cost": 50, "ms": 206, "pl_id": 9734570 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/biz_detail' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'biz_no=4398700761' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("biz_no", "4398700761"); const response = await fetch("https://apick.app/rest/biz_detail", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("biz_no", (None, "4398700761")), ] response = requests.request("POST", "https://apick.app/rest/biz_detail", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '4398700761', ]; $curl = curl_init('https://apick.app/rest/biz_detail'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 Method URL POST https://apick.app/rest/biz_detail 최대 처리시간 30초 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 data 하위 필드는 값을 확보한 출처에 따라 세 그룹으로 나뉩니다. 아래 필수 열의 O는 조회에 성공하면 항상 키가 존재하는 필드(값만 빈 문자열일 수 있음), X는 원천 데이터가 없으면 키 자체가 응답에서 빠지는 필드입니다. 국세청 상태 조회 결과가 없으면 사업자상태코드 등 국세청 전용 필드가, 통신판매업 신고 사업자가 아니거나 공정위 조회에서 일치하는 레코드를 찾지 못하면 통판_ 접두 필드와 법인등록번호_공정위가 그룹째로 응답에서 빠집니다. Body 이름 타입 필수 설명 data Object O 조회 데이터 회사명 String O 회사명 사업자등록번호 String O 사업자등록번호 법인등록번호 String O 법인등록번호 통신판매업번호 String O 통신판매업번호 사업자상태 String O 사업자상태 - 계속사업자 - 휴업자 - 폐업자 - 국세청에 등록되지 않은 사업자입니다 과세유형 String O 과세유형 - 부가가치세 일반과세자 - 부가가치세 간이과세자 - 부가가치세 과세특례자 - 부가가치세 면세사업자 - 수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등 - 고유번호가 부여된 단체 - 부가가치세 간이과세자(세금계산서 발급사업자) 폐업일 String O 폐업일 대표명 String O 대표명 설립일 String O 설립일 업종 String O 업종 업태 String O 업태 종목 String O 종목 국세청관리 업종코드 String O 국세청관리 업종코드 표준산업분류(노동부) 업종코드 String O 표준산업분류(노동부) 업종코드 전화번호 String O 전화번호 팩스번호 String O 팩스번호 직원수 String O 직원수 우편번호 String O 우편번호 지번주소 String O 지번주소 도로명주소 String O 도로명주소 위도 String O 위도 (좌표를 확보하지 못하면 빈 문자열) 경도 String O 경도 (좌표를 확보하지 못하면 빈 문자열) 갱신일 String O 갱신일 최초등록일 String O 최초등록일 사업자상태코드 String X 상태코드01: 계속사업자02: 휴업자03: 폐업자국세청 상태 조회 결과가 있을 때만 포함 과세유형코드 String X 과세유형 코드(국세청 분류). 상세 문구는 과세유형 필드 참고예: 01 일반과세자 등국세청 상태 조회 결과가 있을 때만 포함 단위과세전환폐업여부 String X 단위과세전환폐업여부국세청 상태 조회 결과에 해당 값이 있을 때만 포함 과세유형전환일 String X 과세유형 전환일 (YYYY-MM-DD)국세청 상태 조회 결과에 해당 값이 있을 때만 포함 세금계산서적용일 String X 세금계산서 적용일 (YYYY-MM-DD)국세청 상태 조회 결과에 해당 값이 있을 때만 포함 직전과세유형 String X 직전 과세유형국세청 상태 조회 결과에 해당 값이 있을 때만 포함(해당없음 제외) 법인등록번호_공정위 String X 법인등록번호 (마스킹 없음)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_운영상태 String X 통신판매업 운영상태정상영업휴업폐업통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_법인명 String X 통신판매업 신고 법인명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_인허가번호 String X 통신판매업 인허가번호통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_신고기관 String X 신고기관명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_소재지주소 String X 소재지 주소 (지번)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_도로명주소 String X 소재지 도로명주소통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_대표자명 String X 통신판매업 대표자명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_대표자이메일 String X 대표자 이메일통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_신고일자 String X 통신판매업 신고일자 (YYYY-MM-DD)통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_시도 String X 신고 시·도명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_처리부서 String X 신고 처리부서명통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 통판_관리부서전화 String X 신고 관리부서 전화번호통신판매업 신고 사업자이고 공정위 조회에서 일치하는 레코드를 찾았을 때만 포함 success Integer O 과금 여부0: 실패1: 성공3: 실패(timeout) api Object O API 호출 공통 데이터 success Boolean O API 서버 정상 응답 여부 cost Integer O API 호출 요금 ms Integer O API 응답 시간 pl_id Integer O API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "회사명": "주식회사 에이픽", "사업자등록번호": "4398700761", "법인등록번호": "135811-0317959", "통신판매업번호": "2024-서울금천-0123", "사업자상태": "계속사업자", "과세유형": "부가가치세 일반과세자", "폐업일": "", "대표명": "김찬우", "설립일": "2017-06-07", "업종": "정보통신업", "업태": "시스템 소프트웨어 개발 및 공급업", "종목": "", "전화번호": "02-1234-5678", "우편번호": "08505", "지번주소": "서울특별시 금천구 가산동 371-49", "도로명주소": "서울특별시 금천구 가산디지털2로 101, 15층(가산동)", "위도": "", "경도": "", "직원수": "12", "사업자상태코드": "01", "과세유형코드": "01", "법인등록번호_공정위": "135811-0317959", "통판_운영상태": "정상영업", "통판_법인명": "코드라인주식회사", "통판_인허가번호": "2024-서울금천-0101", "통판_신고기관": "서울특별시 금천구", "통판_시도": "서울특별시", "통판_소재지주소": "서울특별시 금천구 가산동 371-49 번지", "통판_도로명주소": "서울특별시 금천구 가산디지털2로", "통판_대표자명": "김찬우", "통판_대표자이메일": "info@example.com", "통판_신고일자": "2024-01-15", "success": 1 }, "api": { "success": true, "cost": 50, "ms": 206, "pl_id": 9734570 } }