개발가이드

  • 개발가이드

사업자 정보 조회

사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 매출액, 직원수, 설립일, 업종, 종목, 연락처 등)를 조회합니다.

정보

Method
URL
POST
https://apick.app/rest/biz_detail

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
biz_no
String
O
사업자등록번호

응답

Body
이름
타입
설명
data
Object
조회 데이터
회사명
String
회사명
사업자등록번호
String
사업자등록번호
법인등록번호
String
법인등록번호
통신판매업번호
String
통신판매업번호
사업자상태
String
사업자상태
    - 계속사업자
    - 휴업자
    - 폐업자
과세유형
String
과세유형
    - 부가가치세 일반과세자
    - 부가가치세 간이과세자
    - 부가가치세 과세특례자
    - 부가가치세 면세사업자
    - 수익사업을 영위하지 않는 비영리법인이거나 고유번호가 부여된 단체,국가기관 등
    - 고유번호가 부여된 단체
    - 부가가치세 간이과세자(세금계산서 발급사업자)
    - 국세청에 등록되지 않은 사업자등록번호입니다
폐업일
String
폐업일
대표명
String
대표명
설립일
String
설립일
업종
String
업종
업태
String
업태
종목
String
종목
국세청관리 업종코드
String
국세청관리 업종코드
표준산업분류(노동부) 업종코드
String
표준산업분류(노동부) 업종코드
전화번호
String
전화번호
팩스번호
String
팩스번호
직원수
String
직원수
우편번호
String
우편번호
지번주소
String
지번주소
도로명주소
String
도로명주소
위도
String
위도
경도
String
경도
갱신일
String
갱신일
최초등록일
String
최초등록일
사업자상태코드
String
상태코드 (01: 계속, 02: 휴업, 03: 폐업)
과세유형코드
String
과세유형코드
단위과세전환폐업여부
String
단위과세전환폐업여부
과세유형전환일
String
과세유형 전환일 (YYYY-MM-DD)
세금계산서적용일
String
세금계산서 적용일 (YYYY-MM-DD)
직전과세유형
String
직전 과세유형 (해당있는 경우만 표시)
법인등록번호_공정위
String
법인등록번호 (마스킹 없음, 통신판매업 신고 사업자만 해당)
통판_운영상태
String
통신판매업 운영상태 (영업중, 휴업, 폐업 등)
통판_사업자구분
String
법인/개인 구분
통판_법인명
String
통신판매업 신고 법인명
통판_사업자상태
String
신고 상태
통판_인허가번호
String
통신판매업 인허가번호
통판_신고기관
String
신고기관명
통판_소재지주소
String
소재지 주소 (지번)
통판_도로명주소
String
소재지 도로명주소
통판_도메인
String
인터넷 판매 도메인
통판_취급품목
String
판매 취급품목
통판_대표자명
String
통신판매업 대표자명
통판_대표자이메일
String
대표자 이메일
통판_전화번호
String
통신판매업 전화번호
통판_팩스
String
팩스번호
통판_신고일자
String
통신판매업 신고일자 (YYYY-MM-DD)
통판_폐업일자
String
통신판매업 폐업일자 (YYYY-MM-DD)
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/biz_detail" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "biz_no=4398700761"
응답 예시

{
    "data": {
        "회사명": "주식회사 에이픽",
        "사업자등록번호": "4398700761",
        "법인등록번호": "135811-0317959",
        "통신판매업번호": "2024-서울금천-0123",
        "사업자상태": "계속사업자",
        "과세유형": "부가가치세 일반과세자",
        "폐업일": "",
        "대표명": "김찬우",
        "설립일": "2017-06-07",
        "업종": "정보통신업",
        "업태": "시스템 소프트웨어 개발 및 공급업",
        "종목": "",
        "전화번호": "02-1234-5678",
        "우편번호": "08505",
        "지번주소": "서울특별시 금천구 가산동 371-49",
        "도로명주소": "서울특별시 금천구 가산디지털2로 101, 15층(가산동)",
        "위도": "",
        "경도": "",
        "직원수": "12",
        "사업자상태코드": "01",
        "과세유형코드": "01",
        "법인등록번호_공정위": "135811-0317959",
        "통판_운영상태": "영업중",
        "통판_사업자구분": "법인",
        "통판_대표자명": "김찬우",
        "통판_대표자이메일": "info@example.com",
        "통판_도메인": "www.example.com",
        "통판_취급품목": "소프트웨어",
        "통판_신고일자": "2024-01-15",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 40,
        "ms": 206,
        "pl_id": 9734570
    }
}
현재 페이지 북마크