# 사업자 정보 조회



사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다. 법인은 기업재무정보(요약재무제표·재무상태표·손익계산서)를 추가 요금 없이 함께 받을 수 있습니다.



인증: Authorization: Bearer $APICK_API_KEY

본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다.

인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.



## POST /rest/biz_detail 응답 필드

- `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다.

- `data.회사명` (string): 사업자등록증에 표시된 상호입니다. 법인은 법인명, 개인사업자는 대표자가 신고한 상호가 들어가며, 조회 결과의 주체를 식별하는 값입니다.

- `data.사업자등록번호` (string): 10자리 사업자등록번호입니다. 하이픈 없이 숫자만 오며, 같은 번호로 사업자 상태·과세 유형을 조회할 수 있습니다.

- `data.법인등록번호` (string): 법원 등기소가 법인에 부여한 13자리 번호입니다. 개인사업자는 값이 없거나 빈 문자열일 수 있으며, 사업자등록번호와 서로 다른 식별자입니다.

- `data.통신판매업번호` (string): 통신판매업 신고번호입니다. 신고 지역·연도·일련번호가 포함되며, 통신판매업자가 아니면 생략됩니다.

- `data.사업자상태` (string): 계속사업자, 휴업자, 폐업자 중 하나입니다. 등록되지 않은 번호면 등록되지 않았다는 안내 문구가 옵니다.

- `data.과세유형` (string): 예: 부가가치세 일반과세자, 부가가치세 간이과세자, 부가가치세 간이과세자(세금계산서 발급사업자), 부가가치세 과세특례자, 부가가치세 면세사업자, 고유번호가 부여된 단체, 수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등.

- `data.폐업일` (string): 사업자가 폐업한 날짜입니다. 현재 영업 중이면 빈 문자열이며, 값이 있으면 사업자 상태가 폐업·휴업일 수 있습니다.

- `data.대표명` (string): 사업자등록증에 등록된 대표자 이름입니다. 법인은 대표이사, 개인사업자는 개인 이름이 들어갑니다.

- `data.설립일` (string): 법인의 설립등기일 또는 개인사업자의 사업 시작일입니다. YYYY-MM-DD 형식이며, 자료에 따라 표기가 다를 수 있습니다.

- `data.업종` (string): 업종 대분류명입니다. 예: 정보통신업, 도매 및 소매업. 사업의 성격을 넓게 보여 줍니다.

- `data.업태` (string): 사업자가 신고한 업태입니다. 업종보다 구체적인 사업 형태를 나타내며, 예: 시스템 소프트웨어 개발 및 공급업.

- `data.종목` (string): 사업자가 신고한 종목입니다. 실제 취급 품목·서비스를 적으며, 신고하지 않았으면 빈 문자열입니다.

- `data.전화번호` (string): 사업장 대표 전화번호입니다. 지역번호가 포함될 수 있고, 자료에 따라 하이픈이 있거나 없을 수 있습니다.

- `data.우편번호` (string): 사업장 주소의 5자리 우편번호입니다. 도로명주소와 함께 배송·세금계산서 발행에 사용할 수 있습니다.

- `data.지번주소` (string): 사업장의 지번 기준 주소입니다. 동·번지까지 표시되며, 도로명주소와 함께 제공됩니다.

- `data.도로명주소` (string): 사업장의 도로명 기준 주소입니다. 건물번호까지 포함되며, 우편 발송·방문 주소로 사용할 수 있습니다.

- `data.등기상호` (string): 등기부에 기록된 상호입니다. 법인이면 사업자등록 상호와 다를 수 있습니다. 확인하지 못하면 빈 문자열입니다.

- `data.등기주소` (string): 등기부에 기록된 본점 주소입니다. 사업장 주소(도로명주소)와 다를 수 있으므로 두 값을 구분해 쓰세요.

- `data.등기상태` (string): 등기기록 상태 표기입니다. 해산·폐쇄 등으로 표시되면 거래·계약 전에 확인이 필요합니다.

- `data.등기소` (string): 관할 등기소입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.위도` (string): 사업장 위도입니다. 좌표가 없으면 빈 문자열입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.경도` (string): 사업장 경도입니다. 좌표가 없으면 빈 문자열입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.직원수` (string): 사업장에서 신고한 직원 수입니다. 문자열로 오며, 자료에 따라 빈 값이거나 추정치일 수 있습니다.

- `data.상세정보확보` (string): Y: 회사명·주소 같은 상세정보가 담겼습니다. N: 상태값만 담겼습니다. N이면 상세 항목을 사용자에게 직접 입력받는 식으로 처리하세요.

- `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): 업무 처리 결과 코드입니다. 1은 정상 결과, 0은 실패 또는 무료 응답입니다. 서비스에 따라 2·3처럼 추가 코드를 쓰므로 같은 응답의 status·msg·error 필드도 함께 확인하세요.

- `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): Y: 사업자 본인 요청으로 상세정보 공개가 제한된 사업자입니다. 조회 오류가 아니며, 공개 가능한 상태 정보만 담깁니다.

- `data.정보제한사유` (string): 정보 제한 안내 문구입니다. 정보제한여부=Y일 때만 포함합니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.통판_처리부서` (string): 신고 처리부서명입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.통판_관리부서전화` (string): 신고 관리부서 전화번호입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보` (object): '기업재무정보' 관련 값을 묶은 객체입니다. 하위 필드에 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다.

- `data.기업재무정보.조회결과` (string): Y: 재무정보 제공, N: 제공하지 못함(사유코드·안내 참고). 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.사유코드` (string): 조회결과=N일 때만 옵니다. NOT_CORPORATION: 법인 사업자가 아님, NO_CRNO: 법인등록번호를 확인하지 못함, NO_DATA: 공개된 재무정보가 없는 법인(외부감사 대상이 아닌 소규모 법인 등), TEMPORARY_ERROR: 일시적으로 조회하지 못함(잠시 후 다시 요청).

- `data.기업재무정보.안내` (string): 결과 안내 문구입니다. 조회결과=N이거나 일부 표를 받지 못했을 때 옵니다.

- `data.기업재무정보.사업연도` (string): 재무상태표·손익계산서의 기준 사업연도(YYYY, 가장 최근)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.기준일자` (string): 결산 기준일자(YYYY-MM-DD)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.통화` (string): 금액 통화 코드입니다. 예: KRW. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표` (array): 최근 3개 사업연도 요약재무제표입니다. 최신 연도 순이며 연도별로 연결·별도가 따로 옵니다.

- `data.기업재무정보.요약재무제표[].사업연도` (string): 사업연도(YYYY)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].기준일자` (string): 결산 기준일자입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].재무제표구분` (string): 연결 또는 별도입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].매출액` (string): 매출액(원)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].영업이익` (string): 영업이익(원)입니다. 손실이면 음수입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].법인세차감전순이익` (string): 법인세비용 차감 전 순이익(원)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].당기순이익` (string): 당기순이익(원)입니다. 손실이면 음수입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].자산총계` (string): 자산총계(원)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].부채총계` (string): 부채총계(원)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].자본총계` (string): 자본총계(원)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].자본금` (string): 자본금(원)입니다. 값이 없으면 0 또는 빈 문자열입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.요약재무제표[].부채비율` (string): 부채비율(%, 소수 둘째 자리)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.재무상태표` (array): 기준 사업연도의 재무상태표 계정과목 목록(연결·별도)입니다. 받지 못하면 빈 배열입니다.

- `data.기업재무정보.재무상태표[].재무제표구분` (string): 연결 또는 별도입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.재무상태표[].계정과목명` (string): 계정과목명입니다. 예: 자산총계, 유동자산, 부채총계, 자본총계, 자본금, 이익잉여금.

- `data.기업재무정보.재무상태표[].당기금액` (string): 당기 금액(원)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.재무상태표[].전기금액` (string): 전기 금액(원)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.재무상태표[].전전기금액` (string): 전전기 금액(원)입니다. 없으면 빈 문자열입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.기업재무정보.손익계산서` (array): 기준 사업연도의 손익계산서 계정과목 목록(연결·별도)입니다. 항목 구조는 재무상태표와 같습니다. 계정과목명 예: 매출액, 영업이익(손실), 법인세차감전순이익(손실), 당기순이익(손실), 총포괄손익. 받지 못하면 빈 배열입니다.

- `api` (object): API 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다.

- `api.success` (boolean): API 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다.

- `api.cost` (integer): 이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다.

- `api.ms` (integer): 서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다.

- `api.pl_id` (integer): 포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다.

## API 요청: POST /rest/biz_detail



### 입력

- `biz_no` (string, 필수): 사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 1234567890)

- `financial_info` (string, 선택): Y 이면 법인의 기업재무정보(최근 3개 사업연도 요약재무제표, 최근 사업연도 재무상태표·손익계산서)를 기업재무정보 필드에 함께 반환합니다. 법인만 제공되며 추가 요금은 없습니다. 재무정보가 없으면 기업재무정보.조회결과=N 과 사유코드를 반환합니다. 가능한 값은 2가지입니다. Y = 재무정보를 결과에 함께 담습니다. N = 재무정보 없이 기본 정보만 담습니다. 허용값: Y, N



### 응답 명세

```json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "회사명": {
          "type": "string",
          "description": "상호입니다."
        },
        "사업자등록번호": {
          "type": "string",
          "description": "사업자등록번호 10자리입니다."
        },
        "법인등록번호": {
          "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": "사업장 경도입니다. 좌표가 없으면 빈 문자열입니다."
        },
        "직원수": {
          "type": "string",
          "description": "직원 수입니다."
        },
        "상세정보확보": {
          "type": "string",
          "description": "Y: 회사명·주소 같은 상세정보가 담겼습니다. N: 상태값만 담겼습니다. N이면 상세 항목을 사용자에게 직접 입력받는 식으로 처리하세요."
        },
        "사업자상태코드": {
          "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": "1이면 정상 조회입니다."
        },
        "사업자등록 업종코드": {
          "type": "string",
          "description": "사업자등록 업종코드입니다. 키 이름에 공백이 있으므로 data[\"사업자등록 업종코드\"]처럼 읽으세요."
        },
        "표준산업분류 업종코드": {
          "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": "Y: 사업자 본인 요청으로 상세정보 공개가 제한된 사업자입니다. 조회 오류가 아니며, 공개 가능한 상태 정보만 담깁니다."
        },
        "정보제한사유": {
          "type": "string",
          "description": "정보 제한 안내 문구입니다. 정보제한여부=Y일 때만 포함합니다."
        },
        "통판_처리부서": {
          "type": "string",
          "description": "신고 처리부서명입니다."
        },
        "통판_관리부서전화": {
          "type": "string",
          "description": "신고 관리부서 전화번호입니다."
        },
        "기업재무정보": {
          "type": "object",
          "properties": {
            "조회결과": {
              "type": "string",
              "description": "Y: 재무정보 제공, N: 제공하지 못함(사유코드·안내 참고)."
            },
            "사유코드": {
              "type": "string",
              "description": "조회결과=N일 때만 옵니다. NOT_CORPORATION: 법인 사업자가 아님, NO_CRNO: 법인등록번호를 확인하지 못함, NO_DATA: 공개된 재무정보가 없는 법인(외부감사 대상이 아닌 소규모 법인 등), TEMPORARY_ERROR: 일시적으로 조회하지 못함(잠시 후 다시 요청)."
            },
            "안내": {
              "type": "string",
              "description": "결과 안내 문구입니다. 조회결과=N이거나 일부 표를 받지 못했을 때 옵니다."
            },
            "사업연도": {
              "type": "string",
              "description": "재무상태표·손익계산서의 기준 사업연도(YYYY, 가장 최근)입니다."
            },
            "기준일자": {
              "type": "string",
              "description": "결산 기준일자(YYYY-MM-DD)입니다."
            },
            "통화": {
              "type": "string",
              "description": "금액 통화 코드입니다. 예: KRW."
            },
            "요약재무제표": {
              "type": "array",
              "description": "최근 3개 사업연도 요약재무제표입니다. 최신 연도 순이며 연도별로 연결·별도가 따로 옵니다.",
              "items": {
                "type": "object",
                "properties": {
                  "사업연도": {
                    "type": "string",
                    "description": "사업연도(YYYY)입니다."
                  },
                  "기준일자": {
                    "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": "자본금(원)입니다. 값이 없으면 0 또는 빈 문자열입니다."
                  },
                  "부채비율": {
                    "type": "string",
                    "description": "부채비율(%, 소수 둘째 자리)입니다."
                  }
                }
              }
            },
            "재무상태표": {
              "type": "array",
              "description": "기준 사업연도의 재무상태표 계정과목 목록(연결·별도)입니다. 받지 못하면 빈 배열입니다.",
              "items": {
                "type": "object",
                "properties": {
                  "재무제표구분": {
                    "type": "string",
                    "description": "연결 또는 별도입니다."
                  },
                  "계정과목명": {
                    "type": "string",
                    "description": "계정과목명입니다. 예: 자산총계, 유동자산, 부채총계, 자본총계, 자본금, 이익잉여금."
                  },
                  "당기금액": {
                    "type": "string",
                    "description": "당기 금액(원)입니다."
                  },
                  "전기금액": {
                    "type": "string",
                    "description": "전기 금액(원)입니다."
                  },
                  "전전기금액": {
                    "type": "string",
                    "description": "전전기 금액(원)입니다. 없으면 빈 문자열입니다."
                  }
                }
              }
            },
            "손익계산서": {
              "type": "array",
              "description": "기준 사업연도의 손익계산서 계정과목 목록(연결·별도)입니다. 항목 구조는 재무상태표와 같습니다. 계정과목명 예: 매출액, 영업이익(손실), 법인세차감전순이익(손실), 당기순이익(손실), 총포괄손익. 받지 못하면 빈 배열입니다.",
              "items": {}
            }
          }
        }
      }
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "cost": {
          "type": "integer"
        },
        "ms": {
          "type": "integer"
        },
        "pl_id": {
          "type": "integer"
        }
      }
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "회사명": "주식회사 예시",
    "사업자등록번호": "1234567890",
    "법인등록번호": "110111-1234567",
    "통신판매업번호": "2024-서울중구-0123",
    "사업자상태": "계속사업자",
    "과세유형": "부가가치세 일반과세자",
    "폐업일": "",
    "대표명": "홍길동",
    "설립일": "2017-06-07",
    "업종": "정보통신업",
    "업태": "시스템 소프트웨어 개발 및 공급업",
    "종목": "",
    "전화번호": "02-1234-5678",
    "우편번호": "04524",
    "지번주소": "서울특별시 중구 태평로1가 31",
    "도로명주소": "서울특별시 중구 세종대로 110",
    "등기상호": "주식회사 예시",
    "등기주소": "서울특별시 중구 세종대로 110",
    "등기상태": "살아있는 등기",
    "등기소": "서울중앙지방법원 등기국",
    "위도": "",
    "경도": "",
    "직원수": "12",
    "상세정보확보": "Y",
    "사업자상태코드": "01",
    "과세유형코드": "01",
    "통판_법인등록번호": "110111-1234567",
    "통판_운영상태": "정상영업",
    "통판_법인명": "주식회사 예시",
    "통판_인허가번호": "2024-서울중구-0123",
    "통판_신고기관": "서울특별시 중구",
    "통판_시도": "서울특별시",
    "통판_소재지주소": "서울특별시 중구 태평로1가 31",
    "통판_도로명주소": "서울특별시 중구 세종대로 110",
    "통판_대표자명": "홍길동",
    "통판_대표자이메일": "user@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=1234567890'

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("biz_no", "1234567890");
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, "1234567890")),
]
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

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'biz_no' => '1234567890',
];
$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);

```

## 사용 예시 1. 거래처 휴·폐업 확인

거래처 등록이나 정산 전에 사업자가 정상 영업 중인지 확인합니다.

```bash

curl --fail-with-body --request POST 'https://apick.app/rest/biz_detail' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'biz_no=1234567890'

```

- `data.사업자상태`가 `계속사업자`가 아니면 거래를 보류합니다. 폐업이면 `data.폐업일`을 함께 보여 줍니다.

- `data.사업자상태코드`는 상태 정보가 있을 때만 오므로 키가 없을 수 있다고 보고 처리합니다.

## 사용 예시 2. 가입 폼 자동 채움

사업자 회원가입에서 회사명·대표명·주소를 채웁니다.

```bash

curl --fail-with-body --request POST 'https://apick.app/rest/biz_detail' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'biz_no=1234567890'

```

- `data.상세정보확보`가 `N`이면 상세 항목이 비어 있으므로 사용자에게 직접 입력받습니다.

- `data.정보제한여부`가 `Y`이면 사업자 본인 요청으로 공개가 제한된 경우로, 조회 오류가 아닙니다.

## 사용 예시 3. 법인 기업재무정보 함께 받기

여신·거래 한도 심사에서 매출액·부채비율을 함께 볼 때 `financial_info=Y`를 보냅니다. 추가 요금은 없습니다.

```bash

curl --fail-with-body --request POST 'https://apick.app/rest/biz_detail' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'biz_no=1234567890' \
  --form-string 'financial_info=Y'

```

- `data.기업재무정보.조회결과`가 `Y`이면 `요약재무제표[]`의 첫 항목이 가장 최근 연도입니다.

- `조회결과`가 `N`이면 `사유코드`를 봅니다. `NOT_CORPORATION`은 개인사업자, `NO_DATA`는 공개 재무정보가 없는 법인입니다.

## 코드·오류

### 업무 실패 응답

입력 오류·대상 없음·일시 실패는 data.error(사유)와 data.success=0으로 오며 api.cost는 0(과금 없음)입니다. HTTP 상태는 400·404·408·424 중 하나입니다. 입력 오류는 값을 고쳐 다시 요청하고, 408·424는 잠시 후 한 번 다시 시도하세요.

```json

{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": false,
    "cost": 0,
    "ms": 5
  }
}

```

## 상세 기능·요금

이용 전 확인 사업자등록번호 10자리로 회사명·대표명·사업자상태·과세유형·업종·주소·연락처와 통신판매업 신고 정보를 한 번에 조회합니다. 거래처 등록 전 확인, 휴·폐업 여부 점검, 가입 폼 자동 채움에 씁니다. 조회에 성공하면 한 건당 50P가 차감됩니다. 입력 오류나 조회 실패는 data.error로 응답하며 과금되지 않습니다. 최대 처리시간은 30초입니다. 요청 시간 제한을 30초 이상으로 잡으세요. 항목에 따라 값이 있는 조회 결과만 골라 담아 돌려줍니다. 한 조회 결과에 빈 항목이 있어도 다른 결과에 있으면 그 값으로 채워지므로, 같은 요청을 항목별로 나눠 보낼 필요가 없습니다. 어느 결과에도 없는 항목은 빈 문자열입니다. 법인사업자는 등기부에 기록된 상호·본점 주소·등기 상태·관할 등기소도 함께 확인해 등기상호·등기주소·등기상태·등기소로 싣습니다. 등기 본점 주소는 사업장 주소와 다를 수 있어 기존 도로명주소를 바꾸지 않습니다. 확인하지 못하면 이 네 항목은 빈 문자열입니다. financial_info=Y를 함께 보내면 법인의 기업재무정보(요약재무제표·재무상태표·손익계산서)를 추가 요금 없이 같은 응답에 담아 줍니다.

## 상세 요청

항목설정 메서드·주소POST https://apick.app/rest/biz_detail 인증 헤더Authorization: Bearer — 내 계정의 API 인증키 본문 형식multipart/form-data 요청 예시 form-data 전체 예제 보기

## 상세 응답

필드는 두 종류입니다. 항상 포함 필드는 조회에 성공하면 키가 늘 있고 값이 없으면 빈 문자열입니다. 있을 때만 포함 필드는 해당 정보가 없으면 키 자체가 빠집니다. 키가 없을 수 있다고 보고 처리하세요. 기본 정보(항상 포함) 필드타입설명 data.회사명string상호입니다. data.사업자등록번호string사업자등록번호 10자리입니다. data.법인등록번호string법인등록번호입니다. 개인사업자는 빈 문자열입니다. data.통신판매업번호string통신판매업 신고번호입니다. data.사업자상태string계속사업자, 휴업자, 폐업자 중 하나입니다. 등록되지 않은 번호면 등록되지 않았다는 안내 문구가 옵니다. data.과세유형string예: 부가가치세 일반과세자, 부가가치세 간이과세자, 부가가치세 간이과세자(세금계산서 발급사업자), 부가가치세 과세특례자, 부가가치세 면세사업자, 고유번호가 부여된 단체, 수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등. data.폐업일string폐업일입니다. 폐업하지 않았으면 빈 문자열입니다. data.대표명string대표자 이름입니다. data.설립일string설립일(개업일)입니다. data.업종string업종입니다. data.업태string업태입니다. data.종목string종목입니다. data.사업자등록 업종코드string사업자등록 업종코드입니다. 키 이름에 공백이 있으므로 data["사업자등록 업종코드"]처럼 읽으세요. 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.상세정보확보stringY: 회사명·주소 같은 상세정보가 담겼습니다. N: 상태값만 담겼습니다. N이면 상세 항목을 사용자에게 직접 입력받는 식으로 처리하세요. data.successinteger1이면 정상 조회입니다. 상태 정보(있을 때만 포함) 필드타입설명 data.사업자상태코드string01: 계속사업자, 02: 휴업자, 03: 폐업자. 상태 정보가 있을 때만 포함합니다. data.과세유형코드string과세유형 코드입니다. 예: 01 일반과세자. 문구는 과세유형을 보세요. 상태 정보가 있을 때만 포함합니다. data.단위과세전환폐업여부string단위과세 전환에 따른 폐업 여부입니다. 값이 있을 때만 포함합니다. data.과세유형전환일string과세유형 전환일(YYYY-MM-DD)입니다. 값이 있을 때만 포함합니다. data.세금계산서적용일string세금계산서 적용일(YYYY-MM-DD)입니다. 값이 있을 때만 포함합니다. data.직전과세유형string직전 과세유형입니다. 값이 있을 때만 포함합니다(해당없음 제외). data.정보제한여부stringY: 사업자 본인 요청으로 상세정보 공개가 제한된 사업자입니다. 조회 오류가 아니며, 공개 가능한 상태 정보만 담깁니다. data.정보제한사유string정보 제한 안내 문구입니다. 정보제한여부=Y일 때만 포함합니다. 통신판매업 신고 정보(신고 정보가 있을 때만 포함) 필드타입설명 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.통판_처리부서string신고 처리부서명입니다. data.통판_관리부서전화string신고 관리부서 전화번호입니다. 기업재무정보(financial_info=Y일 때만 포함) 필드타입설명 data.기업재무정보.조회결과stringY: 재무정보 제공, N: 제공하지 못함(사유코드·안내 참고). data.기업재무정보.사유코드string조회결과=N일 때만 옵니다. NOT_CORPORATION: 법인 사업자가 아님, NO_CRNO: 법인등록번호를 확인하지 못함, NO_DATA: 공개된 재무정보가 없는 법인(외부감사 대상이 아닌 소규모 법인 등), TEMPORARY_ERROR: 일시적으로 조회하지 못함(잠시 후 다시 요청). data.기업재무정보.안내string결과 안내 문구입니다. 조회결과=N이거나 일부 표를 받지 못했을 때 옵니다. data.기업재무정보.사업연도string재무상태표·손익계산서의 기준 사업연도(YYYY, 가장 최근)입니다. data.기업재무정보.기준일자string결산 기준일자(YYYY-MM-DD)입니다. data.기업재무정보.통화string금액 통화 코드입니다. 예: KRW. data.기업재무정보.요약재무제표[]array최근 3개 사업연도 요약재무제표입니다. 최신 연도 순이며 연도별로 연결·별도가 따로 옵니다. data.기업재무정보.요약재무제표[].사업연도string사업연도(YYYY)입니다. data.기업재무정보.요약재무제표[].기준일자string결산 기준일자입니다. data.기업재무정보.요약재무제표[].재무제표구분string연결 또는 별도입니다. data.기업재무정보.요약재무제표[].매출액string매출액(원)입니다. data.기업재무정보.요약재무제표[].영업이익string영업이익(원)입니다. 손실이면 음수입니다. data.기업재무정보.요약재무제표[].법인세차감전순이익string법인세비용 차감 전 순이익(원)입니다. data.기업재무정보.요약재무제표[].당기순이익string당기순이익(원)입니다. 손실이면 음수입니다. data.기업재무정보.요약재무제표[].자산총계string자산총계(원)입니다. data.기업재무정보.요약재무제표[].부채총계string부채총계(원)입니다. data.기업재무정보.요약재무제표[].자본총계string자본총계(원)입니다. data.기업재무정보.요약재무제표[].자본금string자본금(원)입니다. 값이 없으면 0 또는 빈 문자열입니다. data.기업재무정보.요약재무제표[].부채비율string부채비율(%, 소수 둘째 자리)입니다. data.기업재무정보.재무상태표[]array기준 사업연도의 재무상태표 계정과목 목록(연결·별도)입니다. 받지 못하면 빈 배열입니다. data.기업재무정보.재무상태표[].재무제표구분string연결 또는 별도입니다. data.기업재무정보.재무상태표[].계정과목명string계정과목명입니다. 예: 자산총계, 유동자산, 부채총계, 자본총계, 자본금, 이익잉여금. data.기업재무정보.재무상태표[].당기금액string당기 금액(원)입니다. data.기업재무정보.재무상태표[].전기금액string전기 금액(원)입니다. data.기업재무정보.재무상태표[].전전기금액string전전기 금액(원)입니다. 없으면 빈 문자열입니다. data.기업재무정보.손익계산서[]array기준 사업연도의 손익계산서 계정과목 목록(연결·별도)입니다. 항목 구조는 재무상태표와 같습니다. 계정과목명 예: 매출액, 영업이익(손실), 법인세차감전순이익(손실), 당기순이익(손실), 총포괄손익. 받지 못하면 빈 배열입니다. 금액은 모두 원 단위 숫자 문자열입니다. 재무정보는 하루 한 번 갱신됩니다. 조회결과=N이어도 사업자정보 조회 자체는 성공이며 기본 조회 요금만 청구됩니다. 응답 예시 { "data": { "회사명": "주식회사 예시", "사업자등록번호": "1234567890", "법인등록번호": "110111-1234567", "통신판매업번호": "2024-서울중구-0123", "사업자상태": "계속사업자", "과세유형": "부가가치세 일반과세자", "폐업일": "", "대표명": "홍길동", "설립일": "2017-06-07", "업종": "정보통신업", "업태": "시스템 소프트웨어 개발 및 공급업", "종목": "", "전화번호": "02-1234-5678", "우편번호": "04524", "지번주소": "서울특별시 중구 태평로1가 31", "도로명주소": "서울특별시 중구 세종대로 110", "등기상호": "주식회사 예시", "등기주소": "서울특별시 중구 세종대로 110", "등기상태": "살아있는 등기", "등기소": "서울중앙지방법원 등기국", "위도": "", "경도": "", "직원수": "12", "상세정보확보": "Y", "사업자상태코드": "01", "과세유형코드": "01", "통판_법인등록번호": "110111-1234567", "통판_운영상태": "정상영업", "통판_법인명": "주식회사 예시", "통판_인허가번호": "2024-서울중구-0123", "통판_신고기관": "서울특별시 중구", "통판_시도": "서울특별시", "통판_소재지주소": "서울특별시 중구 태평로1가 31", "통판_도로명주소": "서울특별시 중구 세종대로 110", "통판_대표자명": "홍길동", "통판_대표자이메일": "user@example.com", "통판_신고일자": "2024-01-15", "success": 1 }, "api": { "success": true, "cost": 50, "ms": 206, "pl_id": 9734570 } } 기업재무정보 응답 예시(data.기업재무정보 부분) "기업재무정보": { "조회결과": "Y", "사업연도": "2025", "기준일자": "2025-12-31", "통화": "KRW", "요약재무제표": [ { "사업연도": "2025", "기준일자": "2025-12-31", "재무제표구분": "별도", "매출액": "4250000000", "영업이익": "380000000", "법인세차감전순이익": "352000000", "당기순이익": "291000000", "자산총계": "6120000000", "부채총계": "2480000000", "자본총계": "3640000000", "자본금": "500000000", "부채비율": "68.13" } ], "재무상태표": [ { "재무제표구분": "별도", "계정과목명": "자산총계", "당기금액": "6120000000", "전기금액": "5530000000", "전전기금액": "4870000000" }, { "재무제표구분": "별도", "계정과목명": "부채총계", "당기금액": "2480000000", "전기금액": "2190000000", "전전기금액": "1960000000" } ], "손익계산서": [ { "재무제표구분": "별도", "계정과목명": "매출액", "당기금액": "4250000000", "전기금액": "3870000000", "전전기금액": "" }, { "재무제표구분": "별도", "계정과목명": "영업이익(손실)", "당기금액": "380000000", "전기금액": "312000000", "전전기금액": "" } ] } // 재무정보를 제공하지 못한 경우 "기업재무정보": { "조회결과": "N", "사유코드": "NO_DATA", "안내": "공개된 기업재무정보가 없는 법인입니다." }

## 상세 코드·정책

오류 코드 실패하면 data.error로 응답하며 과금되지 않습니다. data.error의미대처 입력 항목이 잘못됐습니다.biz_no가 없거나 10자리가 아닙니다.하이픈을 빼고 숫자 10자리로 보냅니다. 등록되지 않은 사업자라는 안내 문구형식은 맞지만 등록된 적이 없는 번호입니다.다시 조회해도 결과가 같습니다. 번호를 사용자에게 다시 확인합니다. 조회를 완료할 수 없습니다. 잠시 후 다시 시도해 주세요.일시적으로 조회하지 못했습니다.잠시 후 다시 요청합니다. 처리 시간 초과로 실패했습니다. 잠시후 다시 시도해 주세요.30초 안에 끝나지 않았습니다(data.success=3).잠시 후 다시 요청합니다.
