본문 바로가기

개발자용 API

등기부등본 열람·발급 API

주소 한 줄, 법인등록번호 하나로 부동산·법인 등기사항증명서를 PDF로 바로 받습니다. 한두 건 확인부터 수천 건 대량 발급까지 같은 API로 자동화하세요.

  • 대량 발급도 사람 손 없이
  • 요청 한 번에 PDF까지
  • 실패한 요청은 차감 없음

서비스·시스템에 연동하는 기업·개발자를 위한 API입니다. 인증키로 호출하고 사용한 만큼 포인트가 차감됩니다.

이런 서비스에 연결합니다

  • 정비사업·보상 실무 대량 발급구역 안 토지·건물 목록을 넣어 소유자 확인용 등본을 한 번에 받고, 물건 번호별 PDF로 정리합니다.
  • 공동주택·상가 관리하자보수 청구, 관리단 의사결정, 입주 점포 보상에 필요한 세대·점포별 소유자를 빠르게 확인합니다.
  • 전세·대출 권리 확인계약·심사 흐름에 등본 발급을 넣어 근저당·압류·소유자를 계약 전에 확인합니다.
  • 거래처 법인 확인법인등록번호나 사업자등록번호로 법인 등기를 받아 대표·임원·본점 변경을 거래 전에 확인합니다.

가격과 이용 조건

  • 부동산·법인 등기: 열람 850P · 발급 1,250P · 재다운로드 30P (11/23부터 열람 1,300P · 발급 1,700P)
  • 대상 검색 1건당 40P · 결과가 없어도 검색이 정상으로 끝나면 차감되고, 실패하면 차감하지 않습니다.
  • 열람·발급 전에 실패하면(과다등기·열람 제한·점검 등) 차감하지 않습니다.
  • 최소 1회 포인트 충전(결제) 후 이용할 수 있는 API입니다.
  • 서비스·시스템에 연동하는 기업·개발자용 API입니다. 회원가입 후 발급되는 인증키로 호출합니다.
  • 용도는 열람과 발급 가운데 고릅니다. 주민등록번호는 기본으로 공개하지 않습니다.
  • 받은 PDF는 72시간 동안 보관하며 그 안에는 다시 내려받을 수 있습니다.
  • 등기 정보는 권리 확인 등 정당한 목적으로만 쓰고, 개인정보가 담긴 문서는 귀사의 보관·파기 기준에 따라 관리하세요.

요금 정책 · 처음 연동 가이드

등기부등본 API란?

등기부등본(등기사항증명서)은 부동산과 법인의 권리관계와 그 변동 내역이 담긴 공적 기록입니다. 소유자, 근저당·압류 같은 권리, 법인의 임원과 본점을 확인하는 가장 기본적인 서류입니다.

쓰임새는 계속 늘어납니다. 계약 전 한 건을 확인하는 일도 있지만, 재개발 구역 전체나 대단지 아파트 전 세대처럼 수백·수천 건을 한꺼번에 떼어야 하는 일이 빠르게 늘고 있습니다.

에이픽 등기부등본 API는 이 반복 업무를 프로그램 호출로 바꿉니다. 주소나 고유번호 목록을 넣으면 대상을 확정하고, 열람·발급한 PDF를 물건별로 바로 저장합니다.

손으로 떼던 등기, 이렇게 바뀝니다

  • 한 건씩 직접 열람·발급

    주소·고유번호 목록을 돌며 호출하면 수백·수천 건도 사람 손 없이 순서대로 처리합니다.

  • 화면 캡처·종이로 남는 결과

    등기사항증명서를 PDF 파일로 바로 받아 물건 번호별로 저장·공유합니다. 받은 PDF는 72시간 안에 다시 내려받을 수 있습니다.

  • 비슷한 주소로 엉뚱한 대상 발급

    검색 API로 부동산고유번호를 먼저 확정한 뒤 발급해 동·호 착오를 막습니다.

  • 재전송 때 중복 발급·중복 결제

    idempotency_key 를 같이 보내면 네트워크 오류로 다시 보내도 한 번만 발급·과금합니다.

  • 서류마다 떼는 곳이 달라 따로 처리

    같은 인증키로 건축물대장·토지 정보·실거래가·경매 진행 정보까지 함께 받아 한 흐름으로 묶습니다.

  • 받은 등본이 진짜인지 확인

    발급확인번호만 넣으면 발급 사실과 증명서 종류·발급일을 확인하는 진위 확인 API도 있습니다.

이런 업무에 대량 등기가 필요합니다

  • 재개발·재건축 구역의 토지·건물 소유자 확인과 동의 대상 정리
  • 개발·분양이 끝난 뒤 세대별 소유권 이전 확인
  • 대단지 공동주택 하자보수 청구를 위한 세대별 소유자 확인
  • 대형 상가·오피스 입주 점포의 소유자 확인(의사결정·보상·청구)
  • 도로·철도·송전선로·관로 같은 공공 사업의 보상·용지 매입 대상 권리 확인
  • 경매·공매 물건과 담보 물건의 근저당·압류 변동 상시 점검
  • 조합원·구분소유자의 실제 소유 여부와 주소 확인
  • 거래처 법인의 대표·임원·본점 변경 확인

대량 발급은 이렇게 진행합니다

  1. 발급할 주소 또는 부동산고유번호·법인등록번호 목록을 엑셀이나 CSV로 준비합니다.
  2. 부동산 등기 검색 API로 대상을 찾아 부동산고유번호(pin)를 확정합니다. 검색에 실패하면 차감하지 않습니다.
  3. 열람·발급 API에 pin 과 용도(열람·발급)를 보내면 PDF가 응답으로 바로 옵니다. 파일명을 물건 번호로 저장하세요.
  4. 실패한 건만 모아 다시 보냅니다. 실패한 요청은 포인트를 차감하지 않습니다.

한 계정이 동시에 처리하는 요청 수에는 상한이 있습니다. 429 응답을 받으면 잠시 쉬었다가 같은 요청을 다시 보내세요. 직접 개발하기 어렵거나 정기 대량 발급이 필요하면 맞춤형 API 문의로 상담하세요. 맞춤형 API 문의

이런 곳에서 씁니다

  • 공동주택·아파트 위탁관리
  • 상가·빌딩 관리
  • 시설·자산관리
  • 재개발·재건축 조합과 정비업체
  • 리모델링 추진위원회
  • 시행·시공·도시개발
  • 공공 사업 보상 실무
  • 부동산 컨설팅·시장조사
  • 감정평가
  • 금융·대출 심사
  • 경매·공매 투자
  • 법무·세무·회계 사무소
  • 중개·프롭테크 플랫폼
  • B2B 거래처 심사

함께 쓰는 부동산·법인 API

연동 예제

인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.

cURL
curl -X POST "https://apick.app/rest/registry_realestate_jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"서울특별시 예시구 예시로 123","index":1,"usage":"view"}' \
  -o registry.pdf
Node.js (18 이상) · 목록 대량 발급
import { writeFile } from "node:fs/promises";

const API = "https://apick.app/rest";
const headers = { Authorization: "Bearer " + process.env.APICK_API_KEY, "Content-Type": "application/json" };
const post = (path, body) => fetch(API + path, { method: "POST", headers, body: JSON.stringify(body) });
const addresses = ["서울특별시 예시구 예시로 123", "서울특별시 예시구 예시로 125"]; // 목록 파일에서 읽어 오세요

for (const query of addresses) {
  // ① 대상 확정: 검색 결과의 부동산고유번호(pin)
  const found = await (await post("/registry_realestate_search", { query })).json();
  const target = found.data.targets?.[0];
  if (!target) { console.log("대상 없음", query); continue; }

  // ② 열람 → PDF 저장. 같은 키로 다시 보내면 추가 과금 없이 같은 PDF를 받습니다.
  const res = await post("/registry_realestate_jobs", { pin: target.pin, usage: "view", idempotency_key: "batch-" + target.pin });
  if ((res.headers.get("content-type") || "").includes("application/pdf")) {
    await writeFile(target.pin + ".pdf", Buffer.from(await res.arrayBuffer()));
  } else {
    const { data } = await res.json();
    console.log("다시 보낼 목록", query, data.error_code || data.pdf); // 429·준비 중이면 잠시 뒤 같은 키로
  }
}

응답 예시

HTTP/1.1 200 OK
Content-Type: application/pdf
X-Apick-Job-Id: <작업 번호 · 재다운로드에 사용>
X-Apick-Cost: <차감된 포인트>

(등기사항증명서 PDF 본문)

성공하면 JSON이 아니라 PDF 파일이 바로 옵니다. 실패하면 data.error·data.error_code가 담긴 JSON이 오고 포인트는 차감되지 않습니다.

오류 해결

HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.

  • REGISTRY_TOO_MANY_ACTIVEHTTP 429

    동시에 처리할 수 있는 작업 수를 넘었습니다. 진행 중인 요청이 끝난 뒤 같은 요청을 다시 보내세요.

  • REGISTRY_BAD_REQUESTHTTP 400

    query 또는 pin 이 없거나 형식이 맞지 않습니다. 검색 결과의 pin 을 그대로 넣으세요.

  • REGISTRY_MAINTENANCEHTTP 503

    등기 발급 시스템 점검 시간입니다. 점검이 끝난 뒤 다시 보내세요. 차감되지 않습니다.

  • REGISTRY_POINTS_INSUFFICIENTHTTP 402

    포인트가 부족합니다. 충전한 뒤 같은 요청을 다시 보내세요.

  • REGISTRY_PDF_EXPIREDHTTP 410

    재다운로드 보관 기한(72시간)이 지났습니다. 다시 열람·발급을 요청하세요.

전체 응답 항목과 오류 코드는 개발 문서에 있습니다.

키 발급 → 예제 실행 → 첫 성공까지 몇 분이면 됩니다.