# 부동산 등기 열람·발급 접수



검색 결과에서 고른 부동산의 등기사항증명서 열람·발급을 접수합니다.



인증: Authorization: Bearer $APICK_API_KEY

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

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



## POST /rest/registry_realestate_jobs 응답 필드

- `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 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` (string): 작업이 완료된 일시입니다. 완료 전에는 null이며, 처리 시간을 계산할 때 created_at과 함께 사용합니다.

- `data.pdf` (object): 'pdf' 관련 값을 묶은 객체입니다. 하위 필드에 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다.

- `data.pdf.bytes` (integer): 'bytes' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `data.pdf.pages` (integer): 'pages' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

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

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

- `data.pdf.download_point` (integer): 'download_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `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_realestate_jobs



### 입력

- `query` (string, 필수): 검색에 사용한 주소 또는 부동산고유번호 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `pin` (string, 선택): 부동산고유번호 14자리(선택) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.

- `index` (integer, 선택): 검색 결과 행 번호(1부터), 기본 1 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다.

- `usage` (string, 선택): 열람(view)·발급(issue) 등, 기본 view 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 4가지입니다. view = view 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. issue = issue 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. transfer-gov24 = transfer-gov24 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. transfer-court = transfer-court 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. 허용값: view, issue, transfer-gov24, transfer-court

- `record_scope` (string, 선택): 전부(all)·일부(part), 기본 all 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 2가지입니다. all = all 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. part = part 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. 허용값: all, part

- `include_cancelled` (boolean, 선택): 말소사항 포함 여부, 기본 true true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다.

- `publish_resident_no` (boolean, 선택): 주민등록번호 공개 여부, 기본 false true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다.

- `idempotency_key` (string, 선택): 같은 요청을 다시 보낼 때 중복 접수·과금을 막는 고유 키입니다. 요청 내용이 같으면 같은 키를 유지하고, 내용이 바뀌면 새 키를 만드세요.



### 응답 명세

```json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "job_id": {
          "type": "string"
        },
        "product": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "reserved_point": {
          "type": "integer"
        },
        "download_point": {
          "type": "integer"
        },
        "created_at": {
          "type": "string"
        },
        "completed_at": {
          "type": "string"
        },
        "pdf": {
          "type": "object",
          "properties": {
            "bytes": {
              "type": "integer"
            },
            "pages": {
              "type": "integer"
            },
            "sha256": {
              "type": "string"
            },
            "expires_at": {
              "type": "string"
            },
            "download_point": {
              "type": "integer"
            }
          }
        }
      }
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "cost": {
          "type": "integer"
        }
      }
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "job_id": "8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
    "product": "realestate",
    "status": "completed",
    "reserved_point": 0,
    "download_point": 0,
    "created_at": "2026-10-19T05:10:00.000Z",
    "completed_at": "2026-10-19T05:12:31.000Z",
    "pdf": {
      "bytes": 182344,
      "pages": 3,
      "sha256": "9c1f...",
      "expires_at": "2026-10-22T05:12:31.000Z",
      "download_point": 20
    }
  },
  "api": {
    "success": true,
    "cost": 0
  }
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/registry_realestate_jobs' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'query=서울특별시 중구 세종대로 110' \
  --form-string 'index=1' \
  --form-string 'usage=view'

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("query", "서울특별시 중구 세종대로 110");
form.append("index", "1");
form.append("usage", "view");
const response = await fetch("https://apick.app/rest/registry_realestate_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 = [
    ("query", (None, "서울특별시 중구 세종대로 110")),
    ("index", (None, "1")),
    ("usage", (None, "view")),
]
response = requests.request("POST", "https://apick.app/rest/registry_realestate_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 = [
    'query' => '서울특별시 중구 세종대로 110',
    'index' => '1',
    'usage' => 'view',
];
$curl = curl_init('https://apick.app/rest/registry_realestate_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/8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f?download=1 응답 필드

- `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 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` (string): 작업이 완료된 일시입니다. 완료 전에는 null이며, 처리 시간을 계산할 때 created_at과 함께 사용합니다.

- `data.pdf` (object): 'pdf' 관련 값을 묶은 객체입니다. 하위 필드에 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다.

- `data.pdf.bytes` (integer): 'bytes' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `data.pdf.pages` (integer): 'pages' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

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

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

- `data.pdf.download_point` (integer): 'download_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `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/8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f?download=1



### 입력



### 응답 명세

```json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "job_id": {
          "type": "string"
        },
        "product": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "reserved_point": {
          "type": "integer"
        },
        "download_point": {
          "type": "integer"
        },
        "created_at": {
          "type": "string"
        },
        "completed_at": {
          "type": "string"
        },
        "pdf": {
          "type": "object",
          "properties": {
            "bytes": {
              "type": "integer"
            },
            "pages": {
              "type": "integer"
            },
            "sha256": {
              "type": "string"
            },
            "expires_at": {
              "type": "string"
            },
            "download_point": {
              "type": "integer"
            }
          }
        }
      }
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "cost": {
          "type": "integer"
        }
      }
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "job_id": "8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
    "product": "realestate",
    "status": "completed",
    "reserved_point": 0,
    "download_point": 0,
    "created_at": "2026-10-19T05:10:00.000Z",
    "completed_at": "2026-10-19T05:12:31.000Z",
    "pdf": {
      "bytes": 182344,
      "pages": 3,
      "sha256": "9c1f...",
      "expires_at": "2026-10-22T05:12:31.000Z",
      "download_point": 20
    }
  },
  "api": {
    "success": true,
    "cost": 0
  }
}

```

### curl

```curl

curl --fail-with-body --request GET 'https://apick.app/rest/registry_jobs/8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f?download=1' \
  --header "Authorization: Bearer $APICK_API_KEY"

```

### Node.js (서버 ESM)

```javascript

const response = await fetch("https://apick.app/rest/registry_jobs/8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f?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
response = requests.request("GET", "https://apick.app/rest/registry_jobs/8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f?download=1",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$curl = curl_init('https://apick.app/rest/registry_jobs/8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f?download=1');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => '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 응답 필드

- `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 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` (string): 작업이 완료된 일시입니다. 완료 전에는 null이며, 처리 시간을 계산할 때 created_at과 함께 사용합니다.

- `data.pdf` (object): 'pdf' 관련 값을 묶은 객체입니다. 하위 필드에 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다.

- `data.pdf.bytes` (integer): 'bytes' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `data.pdf.pages` (integer): 'pages' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

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

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

- `data.pdf.download_point` (integer): 'download_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `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": {
        "job_id": {
          "type": "string"
        },
        "product": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "reserved_point": {
          "type": "integer"
        },
        "download_point": {
          "type": "integer"
        },
        "created_at": {
          "type": "string"
        },
        "completed_at": {
          "type": "string"
        },
        "pdf": {
          "type": "object",
          "properties": {
            "bytes": {
              "type": "integer"
            },
            "pages": {
              "type": "integer"
            },
            "sha256": {
              "type": "string"
            },
            "expires_at": {
              "type": "string"
            },
            "download_point": {
              "type": "integer"
            }
          }
        }
      }
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "cost": {
          "type": "integer"
        }
      }
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "job_id": "8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
    "product": "realestate",
    "status": "completed",
    "reserved_point": 0,
    "download_point": 0,
    "created_at": "2026-10-19T05:10:00.000Z",
    "completed_at": "2026-10-19T05:12:31.000Z",
    "pdf": {
      "bytes": 182344,
      "pages": 3,
      "sha256": "9c1f...",
      "expires_at": "2026-10-22T05:12:31.000Z",
      "download_point": 20
    }
  },
  "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

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$curl = curl_init('https://apick.app/rest/registry_jobs/' . rawurlencode(getenv('APICK_JOB_ID')) . '');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => '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.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` (string): 작업이 완료된 일시입니다. 완료 전에는 null이며, 처리 시간을 계산할 때 created_at과 함께 사용합니다.

- `data.pdf` (object): 'pdf' 관련 값을 묶은 객체입니다. 하위 필드에 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다.

- `data.pdf.bytes` (integer): 'bytes' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `data.pdf.pages` (integer): 'pages' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

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

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

- `data.pdf.download_point` (integer): 'download_point' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `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": {
        "job_id": {
          "type": "string"
        },
        "product": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "reserved_point": {
          "type": "integer"
        },
        "download_point": {
          "type": "integer"
        },
        "created_at": {
          "type": "string"
        },
        "completed_at": {
          "type": "string"
        },
        "pdf": {
          "type": "object",
          "properties": {
            "bytes": {
              "type": "integer"
            },
            "pages": {
              "type": "integer"
            },
            "sha256": {
              "type": "string"
            },
            "expires_at": {
              "type": "string"
            },
            "download_point": {
              "type": "integer"
            }
          }
        }
      }
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "cost": {
          "type": "integer"
        }
      }
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "job_id": "8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
    "product": "realestate",
    "status": "completed",
    "reserved_point": 0,
    "download_point": 0,
    "created_at": "2026-10-19T05:10:00.000Z",
    "completed_at": "2026-10-19T05:12:31.000Z",
    "pdf": {
      "bytes": 182344,
      "pages": 3,
      "sha256": "9c1f...",
      "expires_at": "2026-10-22T05:12:31.000Z",
      "download_point": 20
    }
  },
  "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

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$curl = curl_init('https://apick.app/rest/registry_jobs/' . rawurlencode(getenv('APICK_JOB_ID')) . '?download=1');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => '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 요약 접수한 작업은 서버가 순서대로 처리합니다. 상태를 조회하다가 completed가 되면 같은 주소에 download=1을 붙여 PDF를 받습니다. MethodAPI entry point기능성공 결과 POST/rest/registry_realestate_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 PDF 다운로드와 과금 항목설명 과금 시점PDF 바이트 전송이 정상 종료된 호출에만 20P. 재다운로드도 20P 보관 기간완료 후 72시간. 지나면 REGISTRY_PDF_EXPIRED(410) 연결 끊김전송이 끝나지 않으면 20P를 차감하지 않음 처리 제한 시간접수 후 20분을 넘으면 실패 처리하고 880P 전액 환급 동시 접수계정당 3건, 대기 50건. 초과하면 429 form-data 전체 예제 보기

## 상세 요청

접수 요청 form-data 전체 예제 보기 접수 시 880P가 예약됩니다. 실제 결제 전에 실패하면 예약한 880P를 전액 환급하고 failed로 끝납니다.

## 상세 코드·정책

상태 조회 응답 { "data": { "job_id": "8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f", "product": "realestate", "status": "completed", "reserved_point": 0, "download_point": 0, "created_at": "2026-10-19T05:10:00.000Z", "completed_at": "2026-10-19T05:12:31.000Z", "pdf": { "bytes": 182344, "pages": 3, "sha256": "9c1f...", "expires_at": "2026-10-22T05:12:31.000Z", "download_point": 20 } }, "api": { "success": true, "cost": 0 } } status의미 waiting대기 중 processing처리 중 completed완료. ?download=1로 PDF 수신 failed실패. error.code·error.message 확인, 880P 환급