{"openapi":"3.0.3","info":{"title":"APICK 벤처기업 정보조회","version":"1.0.0","description":"벤처기업을 대상으로 사업자 정보, 대차대조표, 손익계산서, 투자정보, 벤처기업확인정보를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/venture_biz_info":{"post":{"summary":"벤처기업 정보조회","description":"벤처기업을 대상으로 사업자 정보, 대차대조표, 손익계산서, 투자정보, 벤처기업확인정보를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"ic_id":{"type":"integer","description":"요청 번호입니다. 문의할 때 함께 알려 주세요."},"type":{"type":"integer","description":"요청 종류입니다. 항상 6입니다."},"result":{"type":"object","properties":{"name":{"type":"string","description":"업체명입니다."},"owner":{"type":"string","description":"대표자 이름입니다."},"corp_num":{"type":"string","description":"법인등록번호입니다. 뒷자리는 가려져 옵니다."},"type":{"type":"string","description":"업종입니다."},"main_product":{"type":"string","description":"주생산품입니다."},"hq_biz_num":{"type":"string","description":"본사 사업자등록번호(하이픈 포함)입니다."},"hq_phone":{"type":"string","description":"본사 전화번호입니다. 일부가 가려져 옵니다."},"hq_address":{"type":"string","description":"본사 주소(시·군·구까지)입니다."},"investments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"투자일자입니다."},"amount":{"type":"string","description":"투자금액(원, 쉼표 포함)입니다."},"balance":{"type":"string","description":"변경사항(잔액, 원)입니다."}}},"description":"투자 이력입니다. 없으면 빈 배열입니다."},"venture_info":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"벤처 확인 유형입니다. 예: 연구개발유형, 기술평가보증기업(기금)."},"date":{"type":"string","description":"공시일입니다."},"exp_date":{"type":"string","description":"유효기간 YYYY-MM-DD ~ YYYY-MM-DD입니다. 끝 날짜가 오늘 이후인 항목이 있으면 현재 벤처기업입니다."},"venture_num":{"type":"string","description":"벤처기업 확인번호입니다."},"create_date":{"type":"string","description":"최초 확인일입니다."},"change_type":{"type":"string","description":"변경사항입니다. 없으면 빈 문자열입니다."}}},"description":"벤처기업 확인 이력입니다. 확인을 받을 때마다 한 항목씩 쌓입니다."},"income_statement":{"type":"object","properties":{"2024":{"type":"object","properties":{"Ⅰ. 매출액":{"type":"string"},"Ⅱ. 매출원가":{"type":"string"},"Ⅲ. 매출총이익(Ⅰ - Ⅱ)":{"type":"string"},"Ⅳ. 판매비와 관리비":{"type":"string"},"Ⅴ. 영업손익(Ⅲ - Ⅳ)":{"type":"string"},"Ⅷ. 당기순손익(Ⅴ+Ⅵ-Ⅶ)":{"type":"string"}}}},"description":"연도별 손익계산서입니다. 키는 연도(예: \"2021\"), 값은 {계정과목명: 금액} 객체입니다. 금액은 원 단위 쉼표 포함 문자열이며 음수는 -로 시작합니다."},"balance_sheet":{"type":"object","properties":{"2024":{"type":"object","properties":{"Ⅰ. 유동자산":{"type":"string"},"Ⅱ. 비유동자산":{"type":"string"}}}},"description":"연도별 대차대조표입니다. 구조는 income_statement와 같습니다."}},"description":"조회 결과입니다. 확인 이력이 있으면 아래 필드를 가진 객체입니다. 등록된 확인 이력이 없으면 객체가 아닌 값이 오고 data.msg에 안내 문구가 담기므로, 객체인지 먼저 확인하세요."},"success":{"type":"integer","description":"1이면 정상 조회(과금)입니다."},"msg":{"type":"string","description":"결과가 객체가 아닐 때만 오는 안내 문구입니다. 정상 조회에서는 없습니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 문의할 때 data.ic_id와 함께 알려 주세요."}}}}}}}},"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"}},"required":["biz_no"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","의미","대처"],"rows":[["입력 항목이 잘못됐습니다.","biz_no가 없거나 10자리가 아닙니다.","하이픈을 빼고 숫자 10자리로 보냅니다."],["처리 시간 초과로 실패했습니다. 잠시후 다시 시도해 주세요.","35초 안에 끝나지 않았습니다. 응답에 data.ic_id가 함께 옵니다.","1~2분 뒤 다시 요청합니다. 같은 번호가 계속 실패하면 ic_id와 함께 문의합니다."],["알 수 없는 이유로 실패했습니다.","일시적인 실패입니다.","잠시 후 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}