본문 바로가기

개발자용 API

사업자 정보 조회 API

사업자등록번호 하나로 상호·대표자·사업자 상태(계속·휴업·폐업)·과세유형·업종·주소를 JSON으로 받습니다. 회원가입·거래처 등록·정산 화면에 바로 연결하세요.

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

서비스·시스템에 연동하는 기업·개발자를 위한 API입니다. 인증키로 호출하고 사용한 만큼 포인트가 차감됩니다.

이런 서비스에 연결합니다

  • B2B 회원가입 확인가입할 때 입력한 사업자번호의 상호·대표자·상태를 확인해 휴·폐업 사업자 가입을 막습니다.
  • 거래처·판매자 등록입점 판매자나 거래처 정보를 사업자번호로 자동 채우고, 주기적으로 상태 변화를 확인합니다.
  • 세금계산서·정산 전 점검발행·지급 전에 과세유형과 사업자 상태를 확인해 반려와 재발행을 줄입니다.

가격과 이용 조건

  • 조회 1건당 50P · 성공한 조회만 과금
  • 가입하면 지급되는 무료 포인트로 바로 호출해 볼 수 있습니다.
  • 서비스·시스템에 연동하는 기업·개발자용 API입니다. 회원가입 후 발급되는 인증키로 호출합니다.
  • 사업자등록번호 10자리(숫자만)를 보냅니다.
  • 조회 결과를 서비스 화면에 보여 주거나 저장할 때는 귀사의 이용 목적·보관 기간 고지를 따르세요.

요금 정책 · 처음 연동 가이드

연동 예제

인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.

cURL
curl -X POST "https://apick.app/rest/biz_detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --form-string "biz_no=1234567890"
Node.js (18 이상)
const form = new FormData();
form.append("biz_no", "1234567890");

const response = await fetch("https://apick.app/rest/biz_detail", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
});
const { data, api } = await response.json();
if (data.error) throw new Error(data.error); // 실패는 과금되지 않습니다
console.log(data, api.cost);

응답 예시

{
  "data": {
    "회사명": "주식회사 예시상사",
    "사업자등록번호": "1234567890",
    "사업자상태": "계속사업자",
    "과세유형": "부가가치세 일반과세자",
    "폐업일": "",
    "대표명": "홍길동",
    "설립일": "2018-03-02",
    "업종": "정보통신업",
    "업태": "응용 소프트웨어 개발 및 공급업",
    "도로명주소": "서울특별시 중구 세종대로 110",
    "사업자상태코드": "01",
    "과세유형코드": "01",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 50,
    "ms": 210
  }
}

예시 값은 가상의 사업자입니다. 전체 응답 항목은 개발 문서에 있습니다.

오류 해결

HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.

  • data.success = 0HTTP 200

    조회에 실패했습니다. data.error의 문구를 확인하세요. 과금되지 않습니다.

  • data.success = 3HTTP 200

    처리 시간이 초과됐습니다. 잠시 후 다시 요청하세요. 과금되지 않습니다.

  • 유효하지 않은 API키 입니다.HTTP 401

    Authorization: Bearer 헤더의 인증키를 확인하세요. 인증키는 마이페이지에서 확인합니다.

  • 허용되지 않은 IP주소 입니다.HTTP 401

    마이페이지의 허용 IP 설정과 요청을 보내는 서버 IP를 확인하세요.

  • 사용 가능한 포인트이 부족합니다.HTTP 200

    HTTP 200이어도 data.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.

전체 응답 항목과 오류 코드는 개발 문서에 있습니다.

키 발급 → 예제 실행 → 첫 성공까지 몇 분이면 됩니다.