# 통신판매업 신고 조회



사업자등록번호로 통신판매업 신고 이력 전부(신고번호·상호·대표자·운영상태·신고일자·신고기관·소재지)를 조회합니다.



인증: Authorization: Bearer $APICK_API_KEY

본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다.

인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.



## POST /rest/ecommerce_registration 응답 필드

- `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다.

- `data.biz_no` (string): 조회한 사업자등록번호(숫자 10자리)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.count` (integer): 신고 이력 수입니다. 0이면 신고 이력이 없는 것이며 요금은 차감됩니다.

- `data.active` (boolean): 운영상태가 정상영업인 신고가 한 건이라도 있으면 true입니다. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다.

- `data.active_count` (integer): 정상영업 중인 신고 수입니다. 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `data.representative` (object): 대표 신고입니다. items의 첫 항목과 같고, 이력이 없으면 null입니다. null 허용.

- `data.representative.신고번호` (string): '신고번호' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.상호` (string): '상호' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.대표자명` (string): '대표자명' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.운영상태` (string): '운영상태' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.신고일자` (string): '신고일자' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.신고기관` (string): '신고기관' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.시도` (string): '시도' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.소재지주소` (string): '소재지주소' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.도로명주소` (string): '도로명주소' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.법인등록번호` (string): '법인등록번호' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.대표자이메일` (string): '대표자이메일' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.담당부서` (string): '담당부서' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.representative.담당부서전화` (string): '담당부서전화' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.items` (array): 조회 결과 항목 목록입니다. 항목이 없으면 빈 배열이며, 각 항목의 필드 구성은 서비스마다 다릅니다.

- `data.items[].신고번호` (string): 통신판매업 신고번호입니다. 예: 2024-서울강남-01234. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].상호` (string): 신고한 상호(법인명)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].운영상태` (string): 정상영업·휴업·폐업 등 신고의 현재 상태입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].신고일자` (string): 신고한 날짜 YYYY-MM-DD입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].…` (string): '…' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.

- `data.items[].대표자명` (string): 대표자 이름입니다. 공동대표는 쉼표로 이어져 옵니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].신고기관` (string): 신고를 받은 시·군·구입니다. 예: 서울특별시 강남구. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].시도` (string): 사업장이 있는 시·도입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].소재지주소` (string): 사업장 지번 주소입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].도로명주소` (string): 사업장 도로명 주소입니다. 건물 번호 없이 도로명까지만 올 수 있습니다.

- `data.items[].법인등록번호` (string): 법인이면 000000-0000000 형식의 법인등록번호이고, 개인사업자는 빈 문자열입니다.

- `data.items[].대표자이메일` (string): 신고서에 적힌 대표 연락 이메일입니다. 없으면 빈 문자열입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].담당부서` (string): 신고를 관리하는 시·군·구 담당 부서입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.items[].담당부서전화` (string): 담당 부서 전화번호입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.success` (integer): 업무 처리 결과 코드입니다. 1은 정상 결과, 0은 실패 또는 무료 응답입니다. 서비스에 따라 2·3처럼 추가 코드를 쓰므로 같은 응답의 status·msg·error 필드도 함께 확인하세요.

- `api` (object): API 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다.

- `api.success` (boolean): API 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다.

- `api.cost` (integer): 이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다.

- `api.ms` (integer): 서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다.

- `api.pl_id` (integer): 포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다.

## API 요청: POST /rest/ecommerce_registration



### 입력

- `biz_no` (string, 필수): 사업자등록번호 10자리입니다. 하이픈 없이 숫자만 입력하며, 검증 숫자(체크섬)가 맞지 않으면 조회 전에 거부됩니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "biz_no": {
          "type": "string",
          "description": "조회한 사업자등록번호(숫자 10자리)입니다."
        },
        "count": {
          "type": "integer",
          "description": "신고 이력 수입니다. 0이면 신고 이력이 없는 것이며 요금은 차감됩니다."
        },
        "active": {
          "type": "boolean",
          "description": "운영상태가 정상영업인 신고가 한 건이라도 있으면 true입니다."
        },
        "active_count": {
          "type": "integer",
          "description": "정상영업 중인 신고 수입니다."
        },
        "representative": {
          "type": "object",
          "properties": {
            "신고번호": {
              "type": "string"
            },
            "상호": {
              "type": "string"
            },
            "대표자명": {
              "type": "string"
            },
            "운영상태": {
              "type": "string"
            },
            "신고일자": {
              "type": "string"
            },
            "신고기관": {
              "type": "string"
            },
            "시도": {
              "type": "string"
            },
            "소재지주소": {
              "type": "string"
            },
            "도로명주소": {
              "type": "string"
            },
            "법인등록번호": {
              "type": "string"
            },
            "대표자이메일": {
              "type": "string"
            },
            "담당부서": {
              "type": "string"
            },
            "담당부서전화": {
              "type": "string"
            }
          },
          "description": "대표 신고입니다. items의 첫 항목과 같고, 이력이 없으면 null입니다.",
          "nullable": true
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "신고번호": {
                "type": "string",
                "description": "통신판매업 신고번호입니다. 예: 2024-서울강남-01234."
              },
              "상호": {
                "type": "string",
                "description": "신고한 상호(법인명)입니다."
              },
              "운영상태": {
                "type": "string",
                "description": "정상영업·휴업·폐업 등 신고의 현재 상태입니다."
              },
              "신고일자": {
                "type": "string",
                "description": "신고한 날짜 YYYY-MM-DD입니다."
              },
              "…": {
                "type": "string"
              },
              "대표자명": {
                "type": "string",
                "description": "대표자 이름입니다. 공동대표는 쉼표로 이어져 옵니다."
              },
              "신고기관": {
                "type": "string",
                "description": "신고를 받은 시·군·구입니다. 예: 서울특별시 강남구."
              },
              "시도": {
                "type": "string",
                "description": "사업장이 있는 시·도입니다."
              },
              "소재지주소": {
                "type": "string",
                "description": "사업장 지번 주소입니다."
              },
              "도로명주소": {
                "type": "string",
                "description": "사업장 도로명 주소입니다. 건물 번호 없이 도로명까지만 올 수 있습니다."
              },
              "법인등록번호": {
                "type": "string",
                "description": "법인이면 000000-0000000 형식의 법인등록번호이고, 개인사업자는 빈 문자열입니다."
              },
              "대표자이메일": {
                "type": "string",
                "description": "신고서에 적힌 대표 연락 이메일입니다. 없으면 빈 문자열입니다."
              },
              "담당부서": {
                "type": "string",
                "description": "신고를 관리하는 시·군·구 담당 부서입니다."
              },
              "담당부서전화": {
                "type": "string",
                "description": "담당 부서 전화번호입니다."
              }
            }
          },
          "description": "신고 이력 목록입니다. 정상영업 신고가 앞에 오고, 같은 상태 안에서는 신고일자 최신순입니다."
        },
        "success": {
          "type": "integer",
          "description": "1이면 정상 조회입니다."
        }
      }
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "cost": {
          "type": "integer",
          "description": "차감된 포인트입니다. 이력이 없거나 실패하면 0 입니다."
        },
        "ms": {
          "type": "integer"
        },
        "pl_id": {
          "type": "integer"
        }
      }
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "biz_no": "9999999906",
    "count": 2,
    "active": true,
    "active_count": 1,
    "representative": {
      "신고번호": "2024-서울강남-01234",
      "상호": "주식회사 가나다상점",
      "대표자명": "홍길동",
      "운영상태": "정상영업",
      "신고일자": "2024-03-15",
      "신고기관": "서울특별시 강남구",
      "시도": "서울특별시",
      "소재지주소": "서울특별시 강남구 역삼동 123 번지",
      "도로명주소": "서울특별시 강남구 테헤란로",
      "법인등록번호": "110111-1234569",
      "대표자이메일": "help@example.com",
      "담당부서": "서울특별시 강남구 일자리경제과",
      "담당부서전화": "02-0000-0000"
    },
    "items": [
      {
        "신고번호": "2024-서울강남-01234",
        "상호": "주식회사 가나다상점",
        "운영상태": "정상영업",
        "신고일자": "2024-03-15",
        "…": "…"
      },
      {
        "신고번호": "2019-경기성남-05678",
        "상호": "주식회사 가나다상점",
        "운영상태": "폐업",
        "신고일자": "2019-07-01",
        "…": "…"
      }
    ],
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 10,
    "ms": 812,
    "pl_id": 1252133
  }
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/ecommerce_registration' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'biz_no=9999999906'

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("biz_no", "9999999906");
const response = await fetch("https://apick.app/rest/ecommerce_registration", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
parts = [
    ("biz_no", (None, "9999999906")),
]
response = requests.request("POST", "https://apick.app/rest/ecommerce_registration",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'biz_no' => '9999999906',
];
$curl = curl_init('https://apick.app/rest/ecommerce_registration');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## 사용 예시 1. 입점 판매자 통신판매업 신고 확인

오픈마켓·쇼핑몰 입점 심사에서 판매자가 낸 통신판매업 신고번호가 정상영업 중인지 확인할 때 씁니다.

```bash

curl --fail-with-body --request POST 'https://apick.app/rest/ecommerce_registration' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'biz_no=9999999906'

```

- `data.active`가 `true`인지 확인합니다. `false`이면 정상영업 중인 신고가 없으므로 입점을 보류합니다.

- 판매자가 입력한 신고번호를 `data.items[]` 중 `운영상태`가 `정상영업`인 항목의 `신고번호`와 비교합니다.

- `상호`·`대표자명`이 사업자 정보와 다르면 담당자 확인 대상으로 넘깁니다.

## 사용 예시 2. 신고 이력이 없는 사업자 처리

자동 심사에서 통신판매업 신고를 하지 않은 사업자를 오류와 구분할 때 씁니다.

```bash

curl --fail-with-body --request POST 'https://apick.app/rest/ecommerce_registration' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'biz_no=9999999906'

```

- `data.error`가 없고 `data.count`가 `0`이면 신고 이력이 없는 사업자입니다. 정상 조회이므로 요금이 차감됩니다.

- `data.error`가 `통신판매업 신고 정보를 가져오지 못했습니다.`로 시작하면 과금되지 않았으니 잠시 후 다시 요청합니다.

## 코드·오류

### 업무 실패 응답

입력 오류·대상 없음·일시 실패는 data.error(사유)와 data.success=0으로 오며 api.cost는 0(과금 없음)입니다. HTTP 상태는 400·404·408·424 중 하나입니다. 입력 오류는 값을 고쳐 다시 요청하고, 408·424는 잠시 후 한 번 다시 시도하세요.

```json

{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 5
  }
}

```

## 상세 기능·요금

이용 전 확인 사업자등록번호 하나로 그 사업자가 신고한 통신판매업 이력 전부를 돌려줍니다. 한 사업자가 본사를 옮기거나 다시 신고하면 이력이 여러 건 쌓이므로, 정상영업 중인 신고를 앞에 두고 같은 상태 안에서는 신고일자가 최신인 순서로 정렬합니다. 오픈마켓·쇼핑몰 입점 심사에서 판매자가 낸 통신판매업 신고번호가 실제로 정상영업 상태인지, 상호·대표자가 사업자 정보와 같은지 확인할 때 씁니다. 신고 이력이 한 건도 없으면 data.count가 0이며, 조회가 정상으로 끝났으므로 요금이 차감됩니다. 입력값이 잘못됐거나 조회에 실패하면 data.error로 응답하며 과금되지 않습니다.

## 상세 요청

항목설정 메서드·주소POST https://apick.app/rest/ecommerce_registration 인증 헤더Authorization: Bearer — 내 계정의 API 인증키 본문 형식multipart/form-data 요청 예시 form-data 전체 예제 보기

## 상세 응답

필드타입설명 data.biz_nostring조회한 사업자등록번호(숫자 10자리)입니다. data.countinteger신고 이력 수입니다. 0이면 신고 이력이 없는 것이며 요금은 차감됩니다. data.activeboolean운영상태가 정상영업인 신고가 한 건이라도 있으면 true입니다. data.active_countinteger정상영업 중인 신고 수입니다. data.representativeobject대표 신고입니다. items의 첫 항목과 같고, 이력이 없으면 null입니다. data.items[]array신고 이력 목록입니다. 정상영업 신고가 앞에 오고, 같은 상태 안에서는 신고일자 최신순입니다. data.items[].신고번호string통신판매업 신고번호입니다. 예: 2024-서울강남-01234. data.items[].상호string신고한 상호(법인명)입니다. data.items[].대표자명string대표자 이름입니다. 공동대표는 쉼표로 이어져 옵니다. data.items[].운영상태string정상영업·휴업·폐업 등 신고의 현재 상태입니다. data.items[].신고일자string신고한 날짜 YYYY-MM-DD입니다. data.items[].신고기관string신고를 받은 시·군·구입니다. 예: 서울특별시 강남구. data.items[].시도string사업장이 있는 시·도입니다. data.items[].소재지주소string사업장 지번 주소입니다. data.items[].도로명주소string사업장 도로명 주소입니다. 건물 번호 없이 도로명까지만 올 수 있습니다. data.items[].법인등록번호string법인이면 000000-0000000 형식의 법인등록번호이고, 개인사업자는 빈 문자열입니다. data.items[].대표자이메일string신고서에 적힌 대표 연락 이메일입니다. 없으면 빈 문자열입니다. data.items[].담당부서string신고를 관리하는 시·군·구 담당 부서입니다. data.items[].담당부서전화string담당 부서 전화번호입니다. data.successinteger1이면 정상 조회입니다. api.costinteger차감된 포인트입니다. 이력이 없거나 실패하면 0 입니다. { "data": { "biz_no": "9999999906", "count": 2, "active": true, "active_count": 1, "representative": { "신고번호": "2024-서울강남-01234", "상호": "주식회사 가나다상점", "대표자명": "홍길동", "운영상태": "정상영업", "신고일자": "2024-03-15", "신고기관": "서울특별시 강남구", "시도": "서울특별시", "소재지주소": "서울특별시 강남구 역삼동 123 번지", "도로명주소": "서울특별시 강남구 테헤란로", "법인등록번호": "110111-1234569", "대표자이메일": "help@example.com", "담당부서": "서울특별시 강남구 일자리경제과", "담당부서전화": "02-0000-0000" }, "items": [ { "신고번호": "2024-서울강남-01234", "상호": "주식회사 가나다상점", "운영상태": "정상영업", "신고일자": "2024-03-15", "…": "…" }, { "신고번호": "2019-경기성남-05678", "상호": "주식회사 가나다상점", "운영상태": "폐업", "신고일자": "2019-07-01", "…": "…" } ], "success": 1 }, "api": { "success": true, "cost": 10, "ms": 812, "pl_id": 1252133 } } 위 응답의 상호·주소·번호는 설명을 위해 만든 값입니다. 요청 예시의 9999999906은 신고 이력이 없는 번호라 실제로 보내면 count 0 으로 응답하고 과금되지 않습니다. 입점 심사에서는 data.active가 true인지 먼저 보고, 판매자가 낸 신고번호가 items[].신고번호 중 정상영업 항목과 같은지 확인합니다.

## 상세 코드·정책

오류 코드 data.error의미대처 사업자등록번호(biz_no)는 숫자 10자리로 보내 주세요. 예: 1234567890biz_no가 없거나 숫자 10자리가 아닙니다.번호를 고쳐 다시 요청합니다. 사업자등록번호(biz_no)가 올바르지 않습니다. 검증 숫자가 맞지 않습니다.10자리이지만 있을 수 없는 번호입니다.번호를 다시 확인합니다. 과금되지 않습니다. 통신판매업 신고 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.일시적으로 조회하지 못했습니다.잠시 후 다시 요청합니다. 과금되지 않습니다.
