본문 바로가기
개발가이드사업자사업자 정보 조회

사업자 정보 조회 API

명세 내보내기
OpenAPI 3.0.3Postman 컬렉션Markdown

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

POSThttps://apick.app/rest/biz_detail
인증
Bearer 키
요청 형식
form-data
응답
JSON
경로
1개

왜 사업자 정보 조회인가

거래처 휴폐업, 계약 전에 바로 확인

사업자 정보를 확인하려 여러 화면을 오가며 복사하는 수작업을 끝내세요. 사업자등록번호 하나로 대표자·주소·업종·사업자상태·과세유형을 받고, 법인은 재무정보까지 함께 봅니다.

도입 효과

  • 휴폐업 거래처와의 계약 사고 예방
  • 입점 사업자 검증 자동화
  • 거래처 정보 입력 오류 제거

이런 곳에서 많이 씁니다

  • B2B 플랫폼 입점사 사업자 검증
  • 도매몰 사업자 회원 자동 승인
  • 세금계산서 발행 전 거래처 확인
  • 영업팀 리드 기업 정보 보강
가입하고 API 키 받기API 키 하나로 바로 호출 · 실패한 요청은 과금되지 않습니다

알아둘 점

이용 전 확인

사업자등록번호 10자리로 회사명·대표명·사업자상태·과세유형·업종·주소·연락처와 통신판매업 신고 정보를 한 번에 조회합니다. 거래처 등록 전 확인, 휴·폐업 여부 점검, 가입 폼 자동 채움에 씁니다.

조회에 성공하면 한 건당 50P가 차감됩니다. 입력 오류나 조회 실패는 data.error로 응답하며 과금되지 않습니다.

최대 처리시간은 30초입니다. 요청 시간 제한을 30초 이상으로 잡으세요.

항목에 따라 값이 있는 조회 결과만 골라 담아 돌려줍니다. 한 조회 결과에 빈 항목이 있어도 다른 결과에 있으면 그 값으로 채워지므로, 같은 요청을 항목별로 나눠 보낼 필요가 없습니다. 어느 결과에도 없는 항목은 빈 문자열입니다.

법인사업자는 등기부에 기록된 상호·본점 주소·등기 상태·관할 등기소도 함께 확인해 등기상호·등기주소·등기상태·등기소로 싣습니다. 등기 본점 주소는 사업장 주소와 다를 수 있어 기존 도로명주소를 바꾸지 않습니다. 확인하지 못하면 이 네 항목은 빈 문자열입니다.

financial_info=Y를 함께 보내면 법인의 기업재무정보(요약재무제표·재무상태표·손익계산서)를 추가 요금 없이 같은 응답에 담아 줍니다.

요청과 응답

API 요청
POST/rest/biz_detail
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 2개 · 필수 1
파라미터
설명
biz_nostring필수
사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 1234567890)
예시
1234567890
financial_infostring선택
Y 이면 법인의 기업재무정보(최근 3개 사업연도 요약재무제표, 최근 사업연도 재무상태표·손익계산서)를 기업재무정보 필드에 함께 반환합니다. 법인만 제공되며 추가 요금은 없습니다. 재무정보가 없으면 기업재무정보.조회결과=N 과 사유코드를 반환합니다. 가능한 값은 2가지입니다. Y = 재무정보를 결과에 함께 담습니다. N = 재무정보 없이 기본 정보만 담습니다.
허용값
Y N
응답 필드 84개
응답 필드
설명
dataobject
요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 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.successinteger
업무 처리 결과 코드입니다. 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
'기업재무정보' 관련 값을 묶은 객체입니다. 하위 필드에 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다.
apiobject
API 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다.
api.successboolean
API 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다.
api.costinteger
이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다.
api.msinteger
서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다.
api.pl_idinteger
포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다.
하위 필드 26개 더 보기
응답 필드
설명
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
기준 사업연도의 손익계산서 계정과목 목록(연결·별도)입니다. 항목 구조는 재무상태표와 같습니다. 계정과목명 예: 매출액, 영업이익(손실), 법인세차감전순이익(손실), 당기순이익(손실), 총포괄손익. 받지 못하면 빈 배열입니다.
입력 조건·전송 규칙
항목
설정
메서드·주소
POST https://apick.app/rest/biz_detail
인증 헤더
Authorization: Bearer — 내 계정의 API 인증키
본문 형식
multipart/form-data
요청 예시

사용 예시

상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.

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

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

요청POST/rest/biz_detail
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. 가입 폼 자동 채움

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

요청POST/rest/biz_detail
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를 보냅니다. 추가 요금은 없습니다.

요청POST/rest/biz_detail
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는 공개 재무정보가 없는 법인입니다.

응답 처리

HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.

필드는 두 종류입니다. 항상 포함 필드는 조회에 성공하면 키가 늘 있고 값이 없으면 빈 문자열입니다. 있을 때만 포함 필드는 해당 정보가 없으면 키 자체가 빠집니다. 키가 없을 수 있다고 보고 처리하세요.

금액은 모두 원 단위 숫자 문자열입니다. 재무정보는 하루 한 번 갱신됩니다. 조회결과=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.회사명
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.상세정보확보
string
Y: 회사명·주소 같은 상세정보가 담겼습니다. N: 상태값만 담겼습니다. N이면 상세 항목을 사용자에게 직접 입력받는 식으로 처리하세요.
data.success
integer
1이면 정상 조회입니다.
상태 정보(있을 때만 포함)
필드
타입
설명
data.사업자상태코드
string
01: 계속사업자, 02: 휴업자, 03: 폐업자. 상태 정보가 있을 때만 포함합니다.
data.과세유형코드
string
과세유형 코드입니다. 예: 01 일반과세자. 문구는 과세유형을 보세요. 상태 정보가 있을 때만 포함합니다.
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.통판_법인명
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.기업재무정보.조회결과
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
기준 사업연도의 손익계산서 계정과목 목록(연결·별도)입니다. 항목 구조는 재무상태표와 같습니다. 계정과목명 예: 매출액, 영업이익(손실), 법인세차감전순이익(손실), 당기순이익(손실), 총포괄손익. 받지 못하면 빈 배열입니다.

오류 코드

응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

  1. HTTP 상태전송·인증·입력 오류
  2. api.successAPI 처리 여부
  3. data · result업무 결과와 오류 문구
  4. api.cost이번 요청의 과금
업무 실패 응답 data.error
  • 입력값이 맞지 않거나 대상 자료가 없거나 일시적으로 처리하지 못하면 data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.
  • 이때 api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.
  • 입력 오류(400)는 값을 고친 뒤 다시 요청하세요. 408·424는 잠시 후 한 번 다시 시도하고, 같은 입력으로 짧은 간격의 자동 반복은 하지 마세요.
{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": false,
    "cost": 0,
    "ms": 5
  }
}
서비스 코드·조건

오류 코드

실패하면 data.error로 응답하며 과금되지 않습니다.

data.error
의미
대처
입력 항목이 잘못됐습니다.
biz_no가 없거나 10자리가 아닙니다.
하이픈을 빼고 숫자 10자리로 보냅니다.
등록되지 않은 사업자라는 안내 문구
형식은 맞지만 등록된 적이 없는 번호입니다.
다시 조회해도 결과가 같습니다. 번호를 사용자에게 다시 확인합니다.
조회를 완료할 수 없습니다. 잠시 후 다시 시도해 주세요.
일시적으로 조회하지 못했습니다.
잠시 후 다시 요청합니다.
처리 시간 초과로 실패했습니다. 잠시후 다시 시도해 주세요.
30초 안에 끝나지 않았습니다(data.success=3).
잠시 후 다시 요청합니다.
인증·포인트 오류 result.error 문구
코드
HTTP
의미·조치
유효하지 않은 API키 입니다.
401
Authorization: Bearer 헤더의 인증키를 확인하세요.
허용되지 않은 IP주소 입니다.
401
마이페이지의 허용 IP 설정과 요청 서버 IP를 확인하세요.
비활성화된 계정입니다.
401
계정 이용 상태를 고객지원으로 문의하세요.
사용 가능한 포인트이 부족합니다.
200
HTTP 200이어도 result.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.
인증 정보를 확인할 수 없습니다.
424
일시적인 확인 실패입니다. 잠시 후 다시 시도하세요.
폼 입력 오류 error.code
코드
HTTP
의미·조치
FORM_DATA_INVALID
400
필드 이름·값의 타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.
FORM_DATA_FIELD_CONFLICT
400
같은 값과 중첩 경로를 동시에 지정하지 마세요.
MULTIPART_LIMIT_OR_PARSE_ERROR
400·413
boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·이용 조건

기본 요금기본 단가 50P · 건당

실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.

연동 팁

  • 요청 예제의 오류 처리 포함 모드는 시간 제한과 업무 실패 판정을 함께 보여줍니다.
  • 인증키는 서버 환경변수에 두고 브라우저·앱에 넣지 마세요.
  • HTTP 성공과 업무 결과를 구분하고, 실패 응답의 오류 문구를 그대로 기록하세요.

개발가이드 검색

API 이름·경로·파라미터·오류 코드로 찾을 수 있습니다.

표시 가격은 기본 단가입니다. 상세 과금 조건은 각 가이드에서 확인하세요.