개발가이드

  • 개발가이드

사업자 정보 조회

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

정보

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
최초등록일
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",
        "설립일": "2017-06-07",
        "주소": "서울특별시 금천구 가산디지털2로 101, 15층 비1504호(가산동, 한라원앤원타워)",
        "대표자": "김찬우",
        "주요업종": "정보통신업",
        "종목": "시스템 소프트웨어 개발 및 공급업",
        "세금유형": "부가가치세 일반과세자",
        "세금상태": "계속사업자",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 40,
        "ms": 206,
        "pl_id": 9734570
    }
}
현재 페이지 북마크