# 부동산종합증명서 열람



토지·건물의 부동산종합증명서를 열람해 JSON과 PDF로 받습니다. 접수 후 결과조회로 받습니다.



인증: Authorization: Bearer $APICK_API_KEY

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

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



## POST /rest/kras_cert_jobs 응답 필드

## API 요청: POST /rest/kras_cert_jobs



### 입력

- `sido_nm` (string, 필수): 시·도 이름 (예: 서울특별시) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.

- `sgg_nm` (string, 필수): 시·군·구 이름 (예: 강남구) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.

- `emd_nm` (string, 필수): 읍·면·동 이름 (예: 역삼동) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.

- `ri_nm` (string, 선택): 리 이름 (읍·면 지역일 때) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `bobn` (string, 필수): 본번 (예: 123) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.

- `bubn` (string, 선택): 부번 (없으면 생략) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `real_gbn` (string, 선택): 토지(L)·건물(B)·집합건물(M), 기본 L 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 3가지입니다. L = L 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. B = 주요사항보고(B)입니다. 합병·분할·대규모 계약처럼 중요한 사건이 생겼을 때 공시됩니다. M = M 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. 허용값: L, B, M

- `doc_format` (string, 선택): 받을 형식. PDF 를 원하면 pdf (JSON 결과는 항상 조회됩니다) 가능한 값은 2가지입니다. json = json 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. pdf = pdf 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. 허용값: json, pdf

- `idempotency_key` (string, 선택): 같은 요청을 다시 보낼 때 중복 접수·과금을 막는 고유 키입니다. 요청 내용이 같으면 같은 키를 유지하고, 내용이 바뀌면 새 키를 만드세요. 키를 생략할 수 있는 API에서 생략하면 같은 요청은 기존 작업으로 처리됩니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/kras_cert_jobs' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'sido_nm=경기도' \
  --form-string 'sgg_nm=성남시 분당구' \
  --form-string 'emd_nm=정자동' \
  --form-string 'bobn=1' \
  --form-string 'bubn=1' \
  --form-string 'real_gbn=L'

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("sido_nm", "경기도");
form.append("sgg_nm", "성남시 분당구");
form.append("emd_nm", "정자동");
form.append("bobn", "1");
form.append("bubn", "1");
form.append("real_gbn", "L");
const response = await fetch("https://apick.app/rest/kras_cert_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 = [
    ("sido_nm", (None, "경기도")),
    ("sgg_nm", (None, "성남시 분당구")),
    ("emd_nm", (None, "정자동")),
    ("bobn", (None, "1")),
    ("bubn", (None, "1")),
    ("real_gbn", (None, "L")),
]
response = requests.request("POST", "https://apick.app/rest/kras_cert_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

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'sido_nm' => '경기도',
    'sgg_nm' => '성남시 분당구',
    'emd_nm' => '정자동',
    'bobn' => '1',
    'bubn' => '1',
    'real_gbn' => 'L',
];
$curl = curl_init('https://apick.app/rest/kras_cert_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);

```

## POST /rest/kras_cert_jobs/status 응답 필드

## API 요청: POST /rest/kras_cert_jobs/status



### 입력

- `job_id` (string, 필수): 접수 응답의 job_id 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/kras_cert_jobs/status' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "job_id=${APICK_JOB_ID}"

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("job_id", process.env.APICK_JOB_ID);
const response = await fetch("https://apick.app/rest/kras_cert_jobs/status", {
  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 = [
    ("job_id", (None, os.environ["APICK_JOB_ID"])),
]
response = requests.request("POST", "https://apick.app/rest/kras_cert_jobs/status",
    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 = [
    'job_id' => getenv('APICK_JOB_ID'),
];
$curl = curl_init('https://apick.app/rest/kras_cert_jobs/status');
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);

```

## POST /rest/kras_cert_jobs/pdf 응답 필드

## API 요청: POST /rest/kras_cert_jobs/pdf



### 입력

- `job_id` (string, 필수): 접수 응답의 job_id 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {}
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/kras_cert_jobs/pdf' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "job_id=${APICK_JOB_ID}" \
  --dump-header response.headers --output result.bin
# response.headers의 Content-Type을 확인한 뒤 파일을 사용하세요.

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("job_id", process.env.APICK_JOB_ID);
const response = await fetch("https://apick.app/rest/kras_cert_jobs/pdf", {
  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()}`);
if ((response.headers.get("content-type") || "").includes("json")) {
  throw new Error(JSON.stringify(await response.json()));
}
const { writeFile } = await import("node:fs/promises");
await writeFile("result.bin", new Uint8Array(await response.arrayBuffer()));

```

### python

```python

import os
import requests
parts = [
    ("job_id", (None, os.environ["APICK_JOB_ID"])),
]
response = requests.request("POST", "https://apick.app/rest/kras_cert_jobs/pdf",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120), stream=True)
response.raise_for_status()
if "json" in response.headers.get("Content-Type", ""):
    raise RuntimeError(response.json())
with open("result.bin", "wb") as output:
    for chunk in response.iter_content(65536):
        output.write(chunk)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'job_id' => getenv('APICK_JOB_ID'),
];
$curl = curl_init('https://apick.app/rest/kras_cert_jobs/pdf');
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);
$type = curl_getinfo($curl, CURLINFO_CONTENT_TYPE) ?: "";
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
if (strpos($type, "json") !== false) { throw new RuntimeException($body); }
file_put_contents('result.bin', $body);

```

## 코드·오류

### 업무 실패 응답

입력 오류·대상 없음·일시 실패는 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
  }
}

```

## 상세 기능·요금

지원 API 요약 접수(제출)와 상태·결과 조회(조회), PDF 다운로드(다운로드) 세 API로 나뉩니다. 접수 직후 200P가 예약 차감되고 job_id와 status(waiting)를 돌려줍니다. 완료되면 상태 조회가 원문 내용(JSON)을, 다운로드가 PDF 문서를 응답합니다(다운로드는 무료). MethodAPI entry point기능성공 결과 POST/rest/kras_cert_jobs열람 접수(200P 예약 차감)job_id·status: "waiting" POST/rest/kras_cert_jobs/status상태·결과(JSON) 조회(무료)status·완료 시 result POST/rest/kras_cert_jobs/pdfPDF 문서 다운로드(무료)application/pdf 과금·환급 항목설명 단가건당 200P입니다. 과금 시점접수 직후 200P 예약 차감이고, 완료되면 확정됩니다. 상태 조회·PDF 다운로드무료(0P)입니다. 환급조회가 실패(failed)하거나 처리 기한을 넘기면 예약 차감한 200P를 전액 환급합니다. 별도 호출이 필요 없습니다. 처리 제한 시간접수 후 최대 180초까지 작업을 처리합니다. 넘기면 실패(환급)로 끝납니다.

## 상세 요청

접수 요청 form-data 전체 예제 보기 접수(대기열 등록) 직후 200P가 예약 차감됩니다. 처리가 끝나면 완료 건에 확정 차감되고, 실패·기한 초과 건은 전액 환급됩니다(아래 과금·환급 참고). 접수 직후에는 취소할 수 없습니다.

## 상세 응답

접수에 성공하면 job_id와 status: "waiting"을 담은 JSON이 옵니다. 이후 상태 조회 API로 확인합니다. 상태는 waiting → processing → completed(성공) 또는 failed(실패)로 바뀝니다. 상황응답 접수 성공data.job_id·data.status: "waiting" 상태 조회 · 처리 중data.status: "waiting"|"processing"와 예상 대기 시간(초). 과금 없음(202) 상태 조회 · 완료data.status: "completed", data.result(원문 JSON)·data.pdf_available 상태 조회 · 실패data.error·data.error_code. 접수 때 차감한 금액 환급 PDF 다운로드 · 완료Content-Type: application/pdf 본문(200)

## 상세 코드·정책

오류 오류는 data.error(안내 문구)와 data.error_code로 옵니다. waiting(처리 중)이면 과금하지 않습니다. error_code의미대처 KRAS_CERT_BAD_REQUEST요청 값이 올바르지 않습니다(400).주소·지번 값을 확인합니다. KRAS_CERT_POINTS_INSUFFICIENT포인트가 부족합니다.충전 후 다시 접수합니다. KRAS_CERT_IDEMPOTENCY_CONFLICT같은 멱등키의 다른 요청이 이미 접수되어 있습니다.같은 요청이면 job_id를 확인하고, 다른 요청이면 새 키로 보냅니다. KRAS_CERT_JOB_NOT_FOUND작업을 찾을 수 없습니다.job_id를 확인합니다. KRAS_CERT_PDF_NOT_READYPDF가 아직 준비되지 않았습니다.작업이 완료된 뒤 다운로드합니다. KRAS_CERT_PDF_EXPIRED보관 기한이 지난 결과입니다(410).다시 접수합니다. KRAS_CERT_TEMPORARILY_UNAVAILABLE일시적으로 처리할 수 없습니다.잠시 후 다시 시도합니다.
