{"openapi":"3.0.3","info":{"title":"APICK 기업 재무정보","version":"1.0.0","description":"법인등록번호와 사업연도로 요약재무제표·재무상태표·손익계산서를 한 번에 받습니다. 부채비율·영업이익률·순이익률·ROA·ROE와 전년 대비 성장률을 함께 계산해 주므로 재무 분석·신용 검토·투자 검토 자료로 바로 쓸 수 있습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/corp_finance":{"post":{"summary":"기업 재무정보","description":"법인등록번호와 사업연도로 요약재무제표·재무상태표·손익계산서를 한 번에 받습니다. 부채비율·영업이익률·순이익률·ROA·ROE와 전년 대비 성장률을 함께 계산해 주므로 재무 분석·신용 검토·투자 검토 자료로 바로 쓸 수 있습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"company":{"type":"object","properties":{"crno":{"type":"string","description":"조회한 법인등록번호 13자리(숫자만)입니다."},"bizYear":{"type":"string","description":"실제로 조회된 사업연도(YYYY)입니다. bizYear를 생략했다면 자동 선택된 연도입니다."},"currency":{"type":"string","description":"금액 통화 코드입니다. 대부분 KRW(원)이며, 다른 값이면 금액을 그 통화로 해석하세요."}}},"summary":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"consolidated(연결)·separate(별도)·other(구분 불명) 중 하나입니다."},"scopeName":{"type":"string","description":"구분 이름입니다. 예: 연결요약재무제표, 별도요약재무제표"},"baseDate":{"type":"string","description":"결산 기준일(YYYY-MM-DD)입니다. 12월 결산이 아니면 연말이 아닐 수 있습니다."},"bizYear":{"type":"string","description":"그 행의 사업연도(YYYY)입니다."},"currency":{"type":"string","description":"그 행의 금액 통화 코드입니다."},"revenue":{"type":"integer","description":"매출액(원)입니다."},"operatingProfit":{"type":"integer","description":"영업이익(원)입니다. 손실이면 음수입니다."},"profitBeforeTax":{"type":"integer","description":"법인세비용차감전순이익(원)입니다."},"netIncome":{"type":"integer","description":"당기순이익(원)입니다. 손실이면 음수입니다."},"totalAssets":{"type":"integer","description":"자산총계(원)입니다."},"totalLiabilities":{"type":"integer","description":"부채총계(원)입니다."},"totalEquity":{"type":"integer","description":"자본총계(원)입니다. 자본잠식이면 음수일 수 있습니다."},"capitalStock":{"type":"integer","description":"자본금(원)입니다."}}},"description":"요약재무제표입니다. 연결·별도마다 한 행씩 옵니다. 금액 필드는 모두 원 단위 숫자이며 값이 없으면 null입니다.","nullable":true},"balance":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","description":"그 계정이 속한 구분입니다. summary[].scope와 같은 값을 씁니다."},"accountId":{"type":"string","description":"계정과목 식별자입니다. 회사·연도가 달라도 같은 계정이면 같은 값이므로 비교·집계 키로 씁니다."},"accountName":{"type":"string","description":"계정과목 이름입니다. 예: 자산총계, 유동부채"},"current":{"type":"integer","description":"당기(조회한 사업연도) 금액(원)입니다."},"previous":{"type":"integer","description":"전기(직전 연도) 금액(원)입니다."},"previous2":{"type":"integer","description":"전전기(2년 전) 금액(원)입니다."},"quarter":{"type":"integer","description":"분기 금액(원)입니다. 연간 재무제표에서는 보통 0입니다."},"quarterEnd":{"type":"integer","description":"분기말 누적 금액(원)입니다. 연간 재무제표에서는 보통 0입니다."},"currency":{"type":"string"}}},"description":"재무상태표 계정과목 목록입니다. 계정마다 한 행이며 연결·별도가 섞여 오면 scope로 나눕니다."},"income":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"accountId":{"type":"string"},"accountName":{"type":"string"},"current":{"type":"integer"},"previous":{"type":"integer"},"previous2":{"type":"integer"},"quarter":{"type":"integer"},"quarterEnd":{"type":"integer"},"currency":{"type":"string"}}},"description":"손익계산서 계정과목 목록입니다. 필드 구성은 balance[]와 같습니다."},"metrics":{"type":"object","properties":{"scope":{"type":"string","description":"비율 계산에 쓴 구분입니다. 연결이 있으면 consolidated, 없으면 첫 행의 구분입니다."},"currency":{"type":"string","description":"비율 계산에 쓴 재무제표의 통화 코드입니다."},"debtRatio":{"type":"number","description":"부채비율(%) = 총부채 ÷ 총자본 × 100. 총자본이 0 이하이면 null입니다.","nullable":true},"operatingMargin":{"type":"number","description":"영업이익률(%) = 영업이익 ÷ 매출액 × 100. 매출액이 0 이하이면 null입니다.","nullable":true},"netMargin":{"type":"number","description":"순이익률(%) = 당기순이익 ÷ 매출액 × 100. 매출액이 0 이하이면 null입니다.","nullable":true},"roa":{"type":"number","description":"총자산이익률(%) = 당기순이익 ÷ 총자산 × 100. 총자산이 0 이하이면 null입니다.","nullable":true},"roe":{"type":"number","description":"자기자본이익률(%) = 당기순이익 ÷ 총자본 × 100. 총자본이 0 이하이면 null입니다.","nullable":true},"revenueGrowth":{"type":"number","description":"매출액 성장률(%) = (당기 − 전기) ÷ 전기 × 100. 전년 자료가 없거나 전기 값이 0 이하이면 null입니다.","nullable":true},"operatingProfitGrowth":{"type":"number","description":"영업이익 성장률(%)입니다. 전기 영업이익이 손실(0 이하)이면 null입니다.","nullable":true},"netIncomeGrowth":{"type":"number","description":"당기순이익 성장률(%)입니다. 전기 순이익이 손실(0 이하)이면 null입니다.","nullable":true}},"description":"재무비율·성장률입니다. summary[]가 비어 있으면(type=balance·income) null입니다.","nullable":true},"count":{"type":"integer","description":"summary[]·balance[]·income[] 행 수의 합입니다."}}},"api":{"type":"object","properties":{"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하거나 결과가 없으면 0입니다."},"success":{"type":"boolean"},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"crno":{"type":"string","description":"법인등록번호 (13자리, 하이픈 없이) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"1100000000001"},"bizYear":{"type":"string","description":"사업연도 (YYYY, 생략하면 가장 최근 연도) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"2024"},"type":{"type":"string","description":"조회 항목 (기본 all=통합) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 4가지입니다. all = all 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. summary = summary 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. balance = balance 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. income = income 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["all","summary","balance","income"],"example":"all"},"scope":{"type":"string","description":"연결·별도 구분 (기본 all) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 3가지입니다. all = all 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. consolidated = consolidated 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. separate = separate 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["all","consolidated","separate"],"example":"all"}},"required":["crno"]}}}}}}},"x-code-tables":[{"title":"type 허용값","columns":["값","채워지는 목록"],"rows":[["all (또는 전체·통합)","summary[]·balance[]·income[] 모두와 metrics (기본값)"],["summary (또는 요약·요약재무제표)","summary[]와 metrics만 채웁니다."],["balance (또는 재무상태표·대차대조표)","balance[]만 채웁니다. metrics는 null입니다."],["income (또는 손익계산서·손익)","income[]만 채웁니다. metrics는 null입니다."]]},{"title":"scope 허용값","columns":["값","의미"],"rows":[["all (또는 전체)","연결·별도를 모두 돌려줍니다 (기본값). 행마다 scope로 구분합니다."],["consolidated (또는 연결·cfs)","종속회사를 합친 연결 재무제표만 돌려줍니다."],["separate (또는 별도·ofs)","회사 단독의 별도(개별) 재무제표만 돌려줍니다."]]},{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["법인등록번호 형식 오류","400","법인등록번호(13자리)가 필요합니다.","숫자 13자리를 보냅니다. 사업자등록번호(10자리)를 넣지 않았는지 확인합니다."],["사업연도 형식 오류","400","사업연도는 4자리(YYYY)입니다.","1900년부터 내년 사이의 4자리 연도로 보내거나 생략합니다."],["type 값 오류","400","조회 항목(type)이 잘못됐습니다.","all·summary·balance·income 중 하나로 보냅니다."],["scope 값 오류","400","연결·별도 구분(scope)이 잘못됐습니다.","all·consolidated·separate 중 하나로 보냅니다."],["입력값이 문자열이 아님","400","조회 조건이 올바르지 않습니다.","같은 이름을 여러 번 보내거나 배열·객체로 보내지 않았는지 확인합니다. 각 항목은 문자열 하나로 보냅니다."],["해당 연도 자료 없음","424","해당 사업연도의 재무정보가 없습니다.","직전 사업연도로 다시 조회합니다. 재무정보를 공개하지 않는 소규모 법인도 이 응답이 옵니다."],["일시적 조회 실패","424","기업 재무정보를 가져오지 못했습니다.","잠시 후 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}