# 법인 등기 검색 법인등록번호(13자리) 또는 사업자등록번호(10자리)로 법인 등기 대상을 찾습니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/registry_corporate_search 응답 필드 - `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다. - `data.corp_reg_no` (string): 'corp_reg_no' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.corp_name` (string): 'corp_name' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.targets` (array): 'targets' 목록입니다. 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. - `data.targets[].index` (integer): 'index' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.targets[].corp_reg_no` (string): 'corp_reg_no' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.targets[].name` (string): 대상의 표시 이름입니다. 같은 API에서도 사람·상품·채널 이름을 뜻할 수 있습니다. - `data.targets[].registry_office` (string): 'registry_office' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.targets[].corp_type` (string): 'corp_type' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.targets[].status` (string): 현재 처리 상태입니다. 서비스별 상태 값과 다음 행동은 같은 문서의 상태 표를 확인하세요. - `data.targets[].head_office` (string): 'head_office' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `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.pl_id` (integer): 포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다. ## API 요청: POST /rest/registry_corporate_search ### 입력 - `corp_reg_no` (string, 선택): 법인등록번호 13자리(하이픈 제외) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. - `biz_no` (string, 선택): 사업자등록번호 10자리(하이픈 제외). corp_reg_no가 없을 때 사용 ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "corp_reg_no": { "type": "string" }, "corp_name": { "type": "string" }, "targets": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer" }, "corp_reg_no": { "type": "string" }, "name": { "type": "string" }, "registry_office": { "type": "string" }, "corp_type": { "type": "string" }, "status": { "type": "string" }, "head_office": { "type": "string" } } } } } }, "api": { "type": "object", "properties": { "success": { "type": "boolean" }, "cost": { "type": "integer" }, "pl_id": { "type": "integer" } } } } } ``` ### 정적 응답 예시 ```json { "data": { "corp_reg_no": "1101111234567", "corp_name": "예시 주식회사", "targets": [ { "index": 1, "corp_reg_no": "1101111234567", "name": "예시 주식회사", "registry_office": "서울중앙등기소", "corp_type": "주식회사", "status": "열람가능", "head_office": "서울특별시 중구 세종대로 110" } ] }, "api": { "success": true, "cost": 40, "pl_id": 12346 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/registry_corporate_search' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'corp_reg_no=110111-1234567' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("corp_reg_no", "110111-1234567"); const response = await fetch("https://apick.app/rest/registry_corporate_search", { 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 = [ ("corp_reg_no", (None, "110111-1234567")), ] response = requests.request("POST", "https://apick.app/rest/registry_corporate_search", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '110111-1234567', ]; $curl = curl_init('https://apick.app/rest/registry_corporate_search'); 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); ``` ## 코드·오류 ## 상세 기능·요금 지원 API 요약 법인등록번호 13자리로 법인 등기 대상을 찾습니다. 사업자등록번호만 있으면 서버가 법인등록번호를 확인한 뒤 검색합니다. MethodAPI entry point기능성공 결과 POST/rest/registry_corporate_search법인 등기 대상 검색HTTP 200과 targets ## 상세 요청 요청 파라미터 corp_reg_no와 biz_no 중 하나는 반드시 있어야 합니다. 둘 다 있으면 corp_reg_no를 사용합니다. form-data 전체 예제 보기 ## 상세 응답 응답 결과 { "data": { "corp_reg_no": "1101111234567", "corp_name": "예시 주식회사", "targets": [ { "index": 1, "corp_reg_no": "1101111234567", "name": "예시 주식회사", "registry_office": "서울중앙등기소", "corp_type": "주식회사", "status": "열람가능", "head_office": "서울특별시 중구 세종대로 110" } ] }, "api": { "success": true, "cost": 40, "pl_id": 12346 } } ## 상세 코드·정책 오류와 과금 상황결과 대상 없음HTTP 200, targets: [], 0P 개인사업자·미등록 법인HTTP 422 REGISTRY_CORP_NO_NOT_FOUND, 0P 입력 오류HTTP 400 REGISTRY_BAD_REQUEST, 0P 처리 시간 초과·서버 오류오류 응답, 0P