{"openapi":"3.0.3","info":{"title":"APICK 사업자 정보 조회","version":"1.0.0","description":"사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다. 법인은 기업재무정보(요약재무제표·재무상태표·손익계산서)를 추가 요금 없이 함께 받을 수 있습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/biz_detail":{"post":{"summary":"사업자 정보 조회","description":"사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다. 법인은 기업재무정보(요약재무제표·재무상태표·손익계산서)를 추가 요금 없이 함께 받을 수 있습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"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"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"biz_no":{"type":"string","description":"사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 1234567890) (string)","example":"1234567890"},"financial_info":{"type":"string","description":"Y 이면 법인의 기업재무정보(최근 3개 사업연도 요약재무제표, 최근 사업연도 재무상태표·손익계산서)를 기업재무정보 필드에 함께 반환합니다. 법인만 제공되며 추가 요금은 없습니다. 재무정보가 없으면 기업재무정보.조회결과=N 과 사유코드를 반환합니다. 가능한 값은 2가지입니다. Y = 재무정보를 결과에 함께 담습니다. N = 재무정보 없이 기본 정보만 담습니다. (string)","enum":["Y","N"]}},"required":["biz_no"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["입력 항목이 잘못됐습니다.","biz_no가 없거나 10자리가 아닙니다.","하이픈을 빼고 숫자 10자리로 보냅니다."],["등록되지 않은 사업자라는 안내 문구","형식은 맞지만 등록된 적이 없는 번호입니다.","다시 조회해도 결과가 같습니다. 번호를 사용자에게 다시 확인합니다."],["조회를 완료할 수 없습니다. 잠시 후 다시 시도해 주세요.","일시적으로 조회하지 못했습니다.","잠시 후 다시 요청합니다."],["처리 시간 초과로 실패했습니다. 잠시후 다시 시도해 주세요.","30초 안에 끝나지 않았습니다(data.success=3).","잠시 후 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}