개발자 문서

등기부등본 API로 등기 변환과 열람을 사내 시스템에 연결하세요

등기클라우드의 등기부등본 API는 두 가지입니다. 이미 받아 둔 등기 PDF를 보내면 갑구와 을구, 공동담보목록을 시트로 나눈 엑셀이나 구조화 JSON을 돌려주는 변환 API가 있고, 주소로 등기를 찾아 열람한 뒤 열람본 PDF를 내려받는 열람 API가 있습니다. 두 API 모두 ENTERPRISE 요금제 기능이고, 로그인한 계정은 체험 키로 변환 API를 누적 10회까지 호출해 볼 수 있습니다.

API 키 관리

키는 발급 시 1회만 표시됩니다. 노출된 키는 즉시 폐기하고 재발급하세요.

ENTERPRISE · 무료 체험로그인

등기 자동화 API로 할 수 있는 일

변환 API (v1)

텍스트가 들어 있는 등기 PDF를 한 번에 100개까지(파일당 30MB) 올리면, 부동산마다 소유자와 지분, 면적, 근저당권자, 채권최고액을 한 줄씩 정리한 엑셀을 돌려줍니다. 작업을 제출하고, 상태를 확인하고, 결과를 받는 세 번의 호출로 끝납니다. 공인중개사, 법무사, 경매투자자용 직군 템플릿을 골라 받을 수도 있습니다.

보유 PDF 데이터 API (v2)

PDF 한 건과 회사가 정한 자산 ID를 보내면 registry-pdf.v1 형식의 구조화 JSON과 엑셀을 함께 만듭니다. 결과는 30일 동안 다시 받을 수 있고, 다시 받아도 월 변환 한도에서 차감되지 않습니다. 응답을 놓쳐 같은 요청을 다시 보내도 두 번 처리되지 않도록 요청마다 멱등 키를 붙입니다.

열람 API

주소를 보내면 등기 후보 목록을 돌려줍니다. 후보를 찾는 검색은 무료입니다. 후보 하나를 골라 열람을 요청하면 서버가 비동기로 처리하고, 끝나면 상태 조회나 웹훅(callback_url)으로 알 수 있습니다. 그다음 열람본 PDF를 내려받습니다. 말소사항을 뺀 현재 유효사항 열람본도 같은 값으로 받을 수 있습니다.

부동산 고유번호를 직접 넣어 여는 방식은 제공하지 않습니다. 후보는 검색 결과의 번호(search_id와 idx)로 고릅니다. 건축물대장, 토지대장, 지적도 같은 대장은 API로 제공하지 않고 웹에서 발급합니다.

쓸 수 있는 요금제와 체험

API 연동은 ENTERPRISE 요금제 기능입니다. ENTERPRISE는 월 499,000원(부가세 포함)이고 월 변환 1,000건이 들어 있습니다. API로 한 변환도 이 한도에서 차감됩니다. 구독하지 않은 계정도 로그인하면 체험 키를 발급받아 변환 API를 누적 10회까지 호출할 수 있습니다.

열람 API는 등기 열람 수수료가 실제로 나가는 기능이라 체험이 없습니다. ENTERPRISE 계정이 결제 카드를 등록해야 쓸 수 있습니다. 요금제마다 무엇이 들어 있는지는 요금에서 비교하실 수 있습니다.

비용

ENTERPRISE 구독월 499,000원부가세 포함입니다. 월 변환 1,000건과 변환 API, 열람 API가 들어 있습니다.
변환 API 체험무료로그인한 계정마다 누적 10회까지입니다.
열람 API 주소 검색무료후보 목록까지는 청구하지 않습니다.
열람 API 신규 열람1건 1,100원부가세 포함입니다.
열람 API 재열람1건 550원부가세 포함입니다. 전에 열람한 등기에 변동이 없을 때의 값입니다.
API 연동 지원(선택)2,000,000원부가세 별도입니다. ENTERPRISE를 구독하는 회사만 신청합니다.

열람 API는 등록한 카드로 나중에 모아 청구하는 후불입니다. 열람이 끝나 신규인지 재열람인지 정해진 뒤의 단가로 기록하고, 실패한 열람은 청구하지 않습니다. 미청구액이 50,000원에 닿거나 한 달이 지나면 등록 카드로 합산해 결제합니다. 미청구액이 100,000원에 닿으면 그 자리에서 결제를 시도하고, 결제되지 않으면 결제될 때까지 열람 API가 멈춥니다. 가입이나 초대로 받은 열람권이 남아 있으면 그것부터 씁니다.

자료와 개인정보

  • 변환 결과의 엑셀과 JSON에서 주민등록번호는 항상 가리며 해제할 수 없습니다.
  • 개인 성명은 기본으로 가립니다. 계정 설정에서 해제하시면 API 결과에도 같은 설정이 적용됩니다. 법인명과 지방자치단체 이름은 가리지 않습니다.
  • 올리신 등기 PDF는 변환이 끝나면 바로 지웁니다.
  • 변환 API(v1)의 결과 엑셀은 한 번 내려받으면 서버에서 지웁니다. 내려받지 않아도 약 30분 뒤에 만료됩니다.
  • v2 결과의 JSON과 엑셀은 30일 동안 보관한 뒤 지웁니다. 그 전에 DELETE 요청으로 직접 지우실 수도 있습니다.
  • 열람 API가 돌려주는 PDF는 열람본입니다. 관공서에 내는 발급본이 아닙니다.
  • API로 받은 등기 데이터는 회원 본인의 업무에만 쓰실 수 있습니다. 제3자에게 다시 팔거나 배포할 수 없고, 열람 API에는 하루 300건 한도가 있습니다.

개발 담당자가 한 명인 회사도 연결할 수 있습니다

등기부등본 API는 큰 개발 조직을 전제로 만들지 않았습니다. 인증은 요청 머리에 API 키 하나를 싣는 방식이고, 변환 API는 세 번, 열람 API는 네 번의 호출로 한 건이 끝납니다. 사내 개발자 한 명이나 외부에 맡긴 개발자가 아래 cURL 예시를 그대로 따라 시작할 수 있습니다.

예를 들어 담보물 목록의 주소로 열람 API를 부르고, 받은 PDF를 변환 API에 보내 엑셀로 정리한 뒤, 그 엑셀을 사내 보고서 양식에 옮기는 흐름을 만들 수 있습니다. 열람 API로 받은 PDF를 변환 API로 정리하면 변환 1건으로 월 변환 한도에서 차감됩니다.

개발 담당자가 없다면 API 없이도 같은 일을 하실 수 있습니다. 주소 목록을 엑셀 양식에 적어 웹 화면에서 한 번에 열람하는 방법은 기업 도입 안내에, 이미 받은 등기 PDF를 올려 엑셀로 받는 방법은 등기 요약(엑셀)에 적었습니다.

처음 연동할 때 함께 확인할 사람이 필요하면 API 연동 지원을 신청하실 수 있습니다. API 키 발급, 개발자 문서 안내, 시험 호출을 함께 하고, 시작한 날부터 30일 동안 연동 질문에 답합니다. 금액은 2,000,000원(부가세 별도)이고 ENTERPRISE를 구독하는 회사만 신청하실 수 있습니다. 귀사 사내 시스템을 만들거나 고치는 개발은 하지 않습니다. 신청과 문의는 문의하기에서 받습니다.

자주 묻는 질문

등기부등본 API는 누가 쓸 수 있나요?

ENTERPRISE 요금제(월 499,000원, 부가세 포함)를 구독하는 계정이 변환 API와 열람 API를 씁니다. 구독하지 않은 계정도 로그인하면 체험 키로 변환 API를 누적 10회까지 호출해 볼 수 있습니다. 열람 API는 체험이 없습니다.

열람 API 요금은 어떻게 청구되나요?

등록한 카드로 나중에 모아 청구하는 후불입니다. 신규 열람은 1건 1,100원, 재열람은 1건 550원이고 모두 부가세 포함입니다. 실패한 열람은 청구하지 않고, 미청구액이 50,000원에 닿거나 한 달이 지나면 합산해 결제합니다. 카드를 등록하지 않으면 열람 요청이 402 오류를 돌려줍니다.

부동산 고유번호로 바로 열람할 수 있나요?

아니요. 열람 API는 주소로 검색한 뒤 후보 목록에서 하나를 고르는 방식입니다. 검색은 무료이고, 후보는 검색 결과의 번호(search_id와 idx)로 지정합니다.

건축물대장이나 토지대장도 API로 받을 수 있나요?

아니요. API로는 등기만 열람합니다. 건축물대장, 토지대장, 지적도, 토지이용계획확인원은 웹 화면에서 발급하실 수 있습니다.

스캔한 등기 PDF도 변환되나요?

텍스트가 들어 있는 등기 PDF만 변환합니다. 스캔본이나 등기가 아닌 PDF는 결과에서 빠지고 월 변환 한도도 쓰지 않습니다. 변환 API 응답의 excluded 항목이 빠진 파일과 그 이유를 알려 줍니다.

결과에 개인정보는 어떻게 나오나요?

주민등록번호는 항상 가리며 해제할 수 없습니다. 개인 성명은 기본으로 가리고, 계정 설정에서 해제하시면 API 결과에도 같은 설정이 적용됩니다. 올리신 PDF는 변환이 끝나면 바로 지웁니다.

사내에 개발자가 없어도 쓸 수 있나요?

API를 연결하려면 개발자 한 명이나 외부에 맡긴 개발자가 필요합니다. 개발 없이 쓰시려면 엑셀 양식과 웹 화면으로 등기를 일괄 열람하고 엑셀로 정리하실 수 있습니다. 연동을 함께 확인하는 API 연동 지원은 2,000,000원(부가세 별도)이고 ENTERPRISE를 구독하는 회사만 신청합니다.

받은 데이터를 다른 서비스에 제공해도 되나요?

안 됩니다. API로 받은 등기 데이터는 회원 본인의 업무에만 쓰실 수 있고, 제3자에게 다시 팔거나 배포할 수 없습니다. 열람 API에는 하루 300건 한도가 있습니다.

API 레퍼런스

베이스 URL: https://deungi.cloud · 인증: 모든 요청 헤더에 Authorization: Bearer <API키> (또는 X-API-Key)

메서드경로설명
POST/api/v1/convertPDF 업로드 → 변환 작업 생성(job_id 반환)
GET/api/v1/jobs/{job_id}작업 상태(queued·running·done·failed)
GET/api/v1/jobs/{job_id}/result완료된 엑셀 다운로드(1회)
보유 등기 PDF 데이터 API v2
POST/api/v2/convertPDF 1건과 자산 ID 제출. 멱등 키 필수
GET/api/v2/jobs/{job_id}작업 상태와 결과 URL
GET/api/v2/jobs/{job_id}/data구조화 JSON 재조회
GET/api/v2/jobs/{job_id}/xlsx같은 작업의 XLSX 재다운로드. 저장한 양식은 ?layout=이름으로 선택
DELETE/api/v2/jobs/{job_id}완료 결과 직접 삭제
등기 열람 API (건당 후불 · 카드 등록 필수)
POST/api/v1/registry/search주소 검색 → 후보 목록(무료). search_id·idx 반환
POST/api/v1/registry/read후보 1건 열람요청(비동기). 성공분만 후불 과금. read_id 반환
카드 미등록·미청구 한도 초과 시 402
GET/api/v1/registry/read/{read_id}열람 상태·결과(reading·done·failed)
GET/api/v1/registry/read/{read_id}/pdf?idx=0등기 PDF 스트리밍

열람요청(/read) 선택 파라미터 — callback_url: 완료 시 {read_id,status} 웹훅 POST 받을 URL(받은 뒤 자기 키로 GET 재조회).
※ 건축물대장·토지대장·지적도 등 대장류는 API로 제공하지 않습니다(등기 열람만). 대장 발급은 웹에서 이용해 주세요.

빠른 시작 — cURL
# 1) 변환 작업 제출 (PDF 여러 개 + 직군 템플릿 선택)
curl -X POST https://deungi.cloud/api/v1/convert \
  -H "Authorization: Bearer dgk_..." \
  -F "files=@등기1.pdf" -F "files=@등기2.pdf" \
  -F "template=agent"
# → {"job_id":"a1b2c3","status":"queued","count":2}

# 2) 상태 조회 (완료되면 download_url 제공)
curl https://deungi.cloud/api/v1/jobs/a1b2c3 \
  -H "Authorization: Bearer dgk_..."
# → {"status":"done","count":2,"download_url":"/api/v1/jobs/a1b2c3/result"}

# 3) 결과 엑셀 다운로드 (1회, 이후 서버에서 삭제)
curl -L https://deungi.cloud/api/v1/jobs/a1b2c3/result \
  -H "Authorization: Bearer dgk_..." -o 등기목록.xlsx
보유 PDF 데이터 API v2 — cURL
# 고객이 보유한 텍스트형 등기 PDF 1건과 자산 ID 제출
# 아래 멱등 키는 예시입니다. 새 작업마다 새 키를 생성하세요.
curl -X POST https://deungi.cloud/api/v2/convert \
  -H "Authorization: Bearer dgk_..." \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -F "asset_id=ASSET-001" -F "file=@synthetic.pdf"
# → {"job_id":"...","status":"queued","status_url":"/api/v2/jobs/..."}

# status_url을 조회해 done을 확인한 뒤 결과를 받습니다.
curl https://deungi.cloud/api/v2/jobs/JOB_ID \
  -H "Authorization: Bearer dgk_..."
curl https://deungi.cloud/api/v2/jobs/JOB_ID/data \
  -H "Authorization: Bearer dgk_..." -o result.json
curl https://deungi.cloud/api/v2/jobs/JOB_ID/xlsx \
  -H "Authorization: Bearer dgk_..." -o result.xlsx
등기 열람 — cURL
# 1) 주소 검색(무료) → 후보 목록
curl -X POST https://deungi.cloud/api/v1/registry/search \
  -H "Authorization: Bearer dgk_..." \
  -F "address=서울 종로구 가회동 1-11"
# → {"search_id":"s1","candidates":[{"idx":0,"address":"...","type":"토지",...}]}

# 2) 열람요청(비동기 · 성공하면 등록카드로 후불 과금)
curl -X POST https://deungi.cloud/api/v1/registry/read \
  -H "Authorization: Bearer dgk_..." \
  -F "search_id=s1" -F "idx=0"
# → {"read_id":"r1","status":"reading"}

# 3) 상태 폴링(수 초~1분) — status가 done이 될 때까지
curl https://deungi.cloud/api/v1/registry/read/r1 \
  -H "Authorization: Bearer dgk_..."
# → {"status":"done","items":[{"idx":0,"title":"등기사항전부증명서","address":"..."}]}

# 4) 등기 PDF 다운로드
curl -L "https://deungi.cloud/api/v1/registry/read/r1/pdf?idx=0" \
  -H "Authorization: Bearer dgk_..." -o 등기부등본.pdf

파라미터

v2 변환 규칙

등기 열람 API 과금 — 등록카드 후불

등기 열람 API 는 결제수단(카드) 등록이 필수입니다. 등록된 카드가 없으면 /registry/read 가 402 를 반환합니다. 결제수단 등록하기 →

제한

이용 조건 · 금지사항

본 API는 회원 본인의 업무용 열람 목적으로만 제공됩니다.
앱 다운로드