{"openapi":"3.0.3","info":{"title":"APICK 사업자 통합 검색","version":"1.0.0","description":"사업자명·대표자명·주소·이메일·전화번호 등 다양한 조건으로 사업자를 검색합니다. 법인/개인사업자 구분·사업자상태·연락처 보유 여부 필터를 지원하고, 결과는 10개씩 페이지 단위로 사업자 정보 조회 수준의 상세 정보(대표자, 주소, 설립일, 업종, 직원수, 연락처, 사업자상태 등)를 담습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/biz_search":{"post":{"summary":"사업자 통합 검색","description":"사업자명·대표자명·주소·이메일·전화번호 등 다양한 조건으로 사업자를 검색합니다. 법인/개인사업자 구분·사업자상태·연락처 보유 여부 필터를 지원하고, 결과는 10개씩 페이지 단위로 사업자 정보 조회 수준의 상세 정보(대표자, 주소, 설립일, 업종, 직원수, 연락처, 사업자상태 등)를 담습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"page":{"type":"integer","description":"현재 페이지 번호입니다."},"per_page":{"type":"integer","description":"한 페이지 항목 수(10)입니다."},"total":{"type":"integer","description":"조건에 맞는 전체 사업자 수입니다."},"total_pages":{"type":"integer","description":"전체 페이지 수입니다. 열람 가능한 최대(max_page)를 넘지 않습니다."},"max_page":{"type":"integer","description":"열람 가능한 최대 페이지(1000)입니다."},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"회사명(상호)입니다."},"biz_no":{"type":"string","description":"사업자등록번호 10자리입니다."},"ceo_name":{"type":"string","description":"대표자명입니다."},"corp_no":{"type":"string","description":"법인등록번호입니다. 개인사업자는 빈 문자열입니다."},"biz_type":{"type":"string","description":"corp 법인, individual 개인사업자입니다. 구분 정보가 없으면 빈 문자열입니다."},"status":{"type":"string","description":"사업자상태 코드입니다. active, closed, suspended, unknown."},"status_label":{"type":"string","description":"사업자상태 한글 표기입니다. 영업, 폐업, 휴업, 알수없음."},"tax_type":{"type":"string","description":"과세유형입니다."},"founded_at":{"type":"string","description":"설립일(개업일)입니다."},"industry_name":{"type":"string","description":"업종명입니다."},"industries":{"type":"array","items":{"type":"string"},"description":"업종 목록입니다."},"address":{"type":"string","description":"주소입니다(도로명주소 우선)."},"sido":{"type":"string","description":"시·도입니다."},"sigungu":{"type":"string","description":"시·군·구입니다."},"zipcode":{"type":"string","description":"우편번호입니다."},"homepage":{"type":"string","description":"홈페이지 주소입니다."},"email":{"type":"string","description":"대표 이메일입니다. 없으면 빈 문자열입니다."},"emails":{"type":"array","items":{"type":"string"},"description":"이메일 목록(최대 3개)입니다."},"phone":{"type":"string","description":"대표 전화번호입니다. 없으면 빈 문자열입니다."},"phones":{"type":"array","items":{"type":"string"},"description":"전화번호 목록(최대 3개)입니다."},"employees":{"type":"integer","description":"직원 수입니다. 없으면 null입니다.","nullable":true},"revenue":{"nullable":true,"type":"integer","description":"매출액(원)입니다. 없으면 null입니다."},"revenue_year":{"nullable":true,"type":"integer","description":"매출액 기준 연도입니다. 없으면 null입니다."},"invest_stage":{"type":"string","description":"투자단계입니다. 없으면 빈 문자열입니다."},"registry_status":{"type":"string","description":"등기 상태 표기입니다. 없으면 빈 문자열입니다."},"closed_at":{"type":"string","description":"폐업일입니다. 폐업하지 않았으면 빈 문자열입니다."},"updated_at":{"type":"string","description":"정보 갱신일입니다."}}},"description":"검색 결과 목록입니다. 관련도 순으로 정렬됩니다."},"message":{"type":"string","description":"결과가 0건일 때만 오는 안내 문구입니다."}}},"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":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"회사명·대표자명·주소·업종을 한 번에 검색하는 통합 키워드입니다. 예: 강남구 커피. (string)","example":"강남구 커피"},"company_name":{"type":"string","description":"회사명(상호)으로 검색합니다. 일부만 입력해도 됩니다. 예: 에이픽. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"ceo_name":{"type":"string","description":"대표자명으로 검색합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"biz_no":{"type":"string","description":"사업자등록번호 10자리로 검색합니다. 하이픈을 넣어도 숫자만 남겨 처리합니다. 예: 123-45-67890. (string)"},"corp_no":{"type":"string","description":"법인등록번호 13자리로 검색합니다. 하이픈을 넣어도 숫자만 남겨 처리합니다. 예: 110111-1234567. (string)"},"email":{"type":"string","description":"검증·발송할 이메일 주소입니다. @와 도메인을 포함한 전체 주소를 보내며, 형식이 맞지 않으면 조회 전에 거부됩니다. (string)"},"phone":{"type":"string","description":"전화번호로 검색합니다. 예: 02-1234-5678. 전화번호를 보유한 사업자만 찾습니다. (string)"},"address":{"type":"string","description":"주소로 검색합니다. 예: 서울특별시 강남구 테헤란로. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"industry":{"type":"string","description":"업종으로 검색합니다. 예: 커피숍. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"sido":{"type":"string","description":"시·도로 거릅니다. 예: 서울특별시. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"sigungu":{"type":"string","description":"시·군·구로 거릅니다. 예: 강남구. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"biz_type":{"type":"string","description":"법인/개인사업자 구분입니다. corp 법인, individual 개인사업자. 구분 정보가 없는 사업자는 어느 쪽에도 잡히지 않습니다. (string)","example":"individual"},"status":{"type":"string","description":"사업자상태입니다. active 영업, closed 폐업, suspended 휴업, unknown 알수없음. (string)"},"has_email":{"type":"string","description":"1이면 이메일을 보유한 사업자만, 0이면 보유하지 않은 사업자만 찾습니다. (string)","example":"1"},"has_phone":{"type":"string","description":"1이면 전화번호를 보유한 사업자만, 0이면 보유하지 않은 사업자만 찾습니다. (string)"},"page":{"type":"string","description":"페이지 번호(기본 1, 최대 1000)입니다. 한 페이지 10건입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1"}}}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["검색 조건을 하나 이상 입력해 주세요.","조건이 하나도 없습니다.","검색 조건을 하나 이상 보냅니다."],["지원하지 않는 입력입니다.","허용되지 않은 파라미터를 보냈습니다.","파라미터 이름을 확인합니다."],["사업자등록번호는 숫자 10자리로 입력해 주세요.","biz_no 형식이 틀립니다.","숫자 10자리로 보냅니다(하이픈은 자동으로 지웁니다)."],["법인등록번호는 숫자 13자리로 입력해 주세요.","corp_no 형식이 틀립니다.","숫자 13자리로 보냅니다."],["사업자 검색을 이용할 수 없습니다. 잠시 후 다시 시도해 주세요.","일시적으로 검색하지 못했습니다.","잠시 후 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}