# 법인 등기 열람·발급 접수 법인등록번호로 법인 등기사항증명서 열람·발급을 접수합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/registry_corporate_jobs 응답 필드 - `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다. - `data.replay` (boolean): 'replay' 여부를 true/false로 나타냅니다. 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. - `data.job_id` (string): 'job_id' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.product` (string): 조회한 상품의 내부 코드입니다. 인증요청 때 보낸 product와 같은 값이며, 응답의 result 구조를 해석할 때 기준이 됩니다. - `data.status` (string): 현재 처리 상태 코드입니다. 괄호 안 설명은 이 서비스에서의 상태 의미이며, 값별 다음 행동은 이 문서의 상태 표를 확인하세요. 상태가 바뀌면 같은 경로를 다시 조회합니다. - `data.reserved_point` (integer): 'reserved_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.download_point` (integer): 'download_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.created_at` (string): 작업이 접수된 일시입니다. ISO 8601 형식이며, 결과 만료 시각을 계산할 때 기준으로 사용합니다. - `data.completed_at` (undefined): 작업이 완료된 일시입니다. 완료 전에는 null이며, 처리 시간을 계산할 때 created_at과 함께 사용합니다. null 허용. - `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 요청: POST /rest/registry_corporate_jobs ### 입력 - `corp_reg_no` (string, 선택): 법인등록번호 13자리 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. - `biz_no` (string, 선택): 사업자등록번호 10자리입니다. 하이픈 없이 숫자만 입력하며, 국세청 체크섬이 맞지 않으면 조회 전에 거부됩니다. - `index` (integer, 선택): 검색 결과 행 번호(1부터), 기본 1 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. - `usage` (string, 선택): 열람(view)·발급(issue), 기본 view 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 2가지입니다. view = view 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. issue = issue 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. 허용값: view, issue - `idempotency_key` (string, 선택): 같은 요청을 다시 보낼 때 중복 접수·과금을 막는 고유 키입니다. 요청 내용이 같으면 같은 키를 유지하고, 내용이 바뀌면 새 키를 만드세요. ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "replay": { "type": "boolean" }, "job_id": { "type": "string" }, "product": { "type": "string" }, "status": { "type": "string" }, "reserved_point": { "type": "integer" }, "download_point": { "type": "integer" }, "created_at": { "type": "string" }, "completed_at": { "nullable": true } } }, "api": { "type": "object", "properties": { "success": { "type": "boolean" }, "cost": { "type": "integer" } } } } } ``` ### 정적 응답 예시 ```json { "data": { "replay": false, "job_id": "1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d", "product": "corporate", "status": "waiting", "reserved_point": 880, "download_point": 0, "created_at": "2026-10-19T05:20:00.000Z", "completed_at": null }, "api": { "success": true, "cost": 0 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/registry_corporate_jobs' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'corp_reg_no=110111-1234567' \ --form-string 'usage=view' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("corp_reg_no", "110111-1234567"); form.append("usage", "view"); const response = await fetch("https://apick.app/rest/registry_corporate_jobs", { 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")), ("usage", (None, "view")), ] response = requests.request("POST", "https://apick.app/rest/registry_corporate_jobs", 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', 'usage' => 'view', ]; $curl = curl_init('https://apick.app/rest/registry_corporate_jobs'); 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); ``` ## GET /rest/registry_jobs/:job_id 응답 필드 - `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다. - `data.replay` (boolean): 'replay' 여부를 true/false로 나타냅니다. 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. - `data.job_id` (string): 'job_id' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.product` (string): 조회한 상품의 내부 코드입니다. 인증요청 때 보낸 product와 같은 값이며, 응답의 result 구조를 해석할 때 기준이 됩니다. - `data.status` (string): 현재 처리 상태 코드입니다. 괄호 안 설명은 이 서비스에서의 상태 의미이며, 값별 다음 행동은 이 문서의 상태 표를 확인하세요. 상태가 바뀌면 같은 경로를 다시 조회합니다. - `data.reserved_point` (integer): 'reserved_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.download_point` (integer): 'download_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.created_at` (string): 작업이 접수된 일시입니다. ISO 8601 형식이며, 결과 만료 시각을 계산할 때 기준으로 사용합니다. - `data.completed_at` (undefined): 작업이 완료된 일시입니다. 완료 전에는 null이며, 처리 시간을 계산할 때 created_at과 함께 사용합니다. null 허용. - `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입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다. ## 상태·목록 조회: GET /rest/registry_jobs/:job_id ### 입력 ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "replay": { "type": "boolean" }, "job_id": { "type": "string" }, "product": { "type": "string" }, "status": { "type": "string" }, "reserved_point": { "type": "integer" }, "download_point": { "type": "integer" }, "created_at": { "type": "string" }, "completed_at": { "nullable": true } } }, "api": { "type": "object", "properties": { "success": { "type": "boolean" }, "cost": { "type": "integer" } } } } } ``` ### 정적 응답 예시 ```json { "data": { "replay": false, "job_id": "1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d", "product": "corporate", "status": "waiting", "reserved_point": 880, "download_point": 0, "created_at": "2026-10-19T05:20:00.000Z", "completed_at": null }, "api": { "success": true, "cost": 0 } } ``` ### curl ```curl curl --fail-with-body --request GET "https://apick.app/rest/registry_jobs/${APICK_JOB_ID}" \ --header "Authorization: Bearer $APICK_API_KEY" ``` ### Node.js (서버 ESM) ```javascript const response = await fetch(`https://apick.app/rest/registry_jobs/${encodeURIComponent(process.env.APICK_JOB_ID)}`, { method: "GET", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, 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 from urllib.parse import quote response = requests.request("GET", "https://apick.app" + "/rest/registry_jobs/{job_id}".format(job_id=quote(os.environ["APICK_JOB_ID"], safe="")), headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php 'GET', CURLOPT_HTTPHEADER => $headers, 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); ``` ## GET /rest/registry_jobs/:job_id?download=1 응답 필드 - `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다. - `data.replay` (boolean): 'replay' 여부를 true/false로 나타냅니다. 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. - `data.job_id` (string): 'job_id' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.product` (string): 조회한 상품의 내부 코드입니다. 인증요청 때 보낸 product와 같은 값이며, 응답의 result 구조를 해석할 때 기준이 됩니다. - `data.status` (string): 현재 처리 상태 코드입니다. 괄호 안 설명은 이 서비스에서의 상태 의미이며, 값별 다음 행동은 이 문서의 상태 표를 확인하세요. 상태가 바뀌면 같은 경로를 다시 조회합니다. - `data.reserved_point` (integer): 'reserved_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.download_point` (integer): 'download_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.created_at` (string): 작업이 접수된 일시입니다. ISO 8601 형식이며, 결과 만료 시각을 계산할 때 기준으로 사용합니다. - `data.completed_at` (undefined): 작업이 완료된 일시입니다. 완료 전에는 null이며, 처리 시간을 계산할 때 created_at과 함께 사용합니다. null 허용. - `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입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다. ## 상태·목록 조회: GET /rest/registry_jobs/:job_id?download=1 ### 입력 ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "replay": { "type": "boolean" }, "job_id": { "type": "string" }, "product": { "type": "string" }, "status": { "type": "string" }, "reserved_point": { "type": "integer" }, "download_point": { "type": "integer" }, "created_at": { "type": "string" }, "completed_at": { "nullable": true } } }, "api": { "type": "object", "properties": { "success": { "type": "boolean" }, "cost": { "type": "integer" } } } } } ``` ### 정적 응답 예시 ```json { "data": { "replay": false, "job_id": "1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d", "product": "corporate", "status": "waiting", "reserved_point": 880, "download_point": 0, "created_at": "2026-10-19T05:20:00.000Z", "completed_at": null }, "api": { "success": true, "cost": 0 } } ``` ### curl ```curl curl --fail-with-body --request GET "https://apick.app/rest/registry_jobs/${APICK_JOB_ID}?download=1" \ --header "Authorization: Bearer $APICK_API_KEY" ``` ### Node.js (서버 ESM) ```javascript const response = await fetch(`https://apick.app/rest/registry_jobs/${encodeURIComponent(process.env.APICK_JOB_ID)}?download=1`, { method: "GET", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, 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 from urllib.parse import quote response = requests.request("GET", "https://apick.app" + "/rest/registry_jobs/{job_id}?download=1".format(job_id=quote(os.environ["APICK_JOB_ID"], safe="")), headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php 'GET', CURLOPT_HTTPHEADER => $headers, 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 요약 법인등록번호로 법인 등기사항증명서 열람·발급을 접수합니다. 사업자등록번호만 있으면 서버가 법인등록번호를 확인한 뒤 접수합니다. MethodAPI entry point기능성공 결과 POST/rest/registry_corporate_jobs열람·발급 접수(880P 예약)HTTP 202와 job_id GET/rest/registry_jobs/{job_id}상태 조회HTTP 200, 0P GET/rest/registry_jobs/{job_id}?download=1PDF 다운로드(20P)application/pdf ## 상세 요청 접수 요청 form-data 전체 예제 보기 접수 시 880P가 예약됩니다. 결제 전 실패는 880P 전액 환급 후 failed로 끝납니다. ## 상세 코드·정책 응답과 상태 { "data": { "replay": false, "job_id": "1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d", "product": "corporate", "status": "waiting", "reserved_point": 880, "download_point": 0, "created_at": "2026-10-19T05:20:00.000Z", "completed_at": null }, "api": { "success": true, "cost": 0 } } 상태 값과 PDF 과금 규칙은 부동산 열람 접수와 같습니다. 완료 후 GET /rest/registry_jobs/{job_id}?download=1로 PDF를 받고, 전송이 끝난 호출마다 20P가 차감됩니다. 항목설명 처리 제한 시간접수 후 20분 초과 시 실패, 880P 전액 환급 PDF 보관완료 후 72시간 동시 접수계정당 3건, 대기 50건. 초과 시 429 대상 없음검색 결과가 없거나 개인사업자면 접수 단계에서 실패, 0P