등기클라우드의 등기부등본 API는 두 가지입니다. 이미 받아 둔 등기 PDF를 보내면 갑구와 을구, 공동담보목록을 시트로 나눈 엑셀이나 구조화 JSON을 돌려주는 변환 API가 있고, 주소로 등기를 찾아 열람한 뒤 열람본 PDF를 내려받는 열람 API가 있습니다. 두 API 모두 ENTERPRISE 요금제 기능이고, 로그인한 계정은 체험 키로 변환 API를 누적 10회까지 호출해 볼 수 있습니다.
키는 발급 시 1회만 표시됩니다. 노출된 키는 즉시 폐기하고 재발급하세요.
텍스트가 들어 있는 등기 PDF를 한 번에 100개까지(파일당 30MB) 올리면, 부동산마다 소유자와 지분, 면적, 근저당권자, 채권최고액을 한 줄씩 정리한 엑셀을 돌려줍니다. 작업을 제출하고, 상태를 확인하고, 결과를 받는 세 번의 호출로 끝납니다. 공인중개사, 법무사, 경매투자자용 직군 템플릿을 골라 받을 수도 있습니다.
PDF 한 건과 회사가 정한 자산 ID를 보내면 registry-pdf.v1 형식의 구조화 JSON과 엑셀을 함께 만듭니다. 결과는 30일 동안 다시 받을 수 있고, 다시 받아도 월 변환 한도에서 차감되지 않습니다. 응답을 놓쳐 같은 요청을 다시 보내도 두 번 처리되지 않도록 요청마다 멱등 키를 붙입니다.
주소를 보내면 등기 후보 목록을 돌려줍니다. 후보를 찾는 검색은 무료입니다. 후보 하나를 골라 열람을 요청하면 서버가 비동기로 처리하고, 끝나면 상태 조회나 웹훅(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가 멈춥니다. 가입이나 초대로 받은 열람권이 남아 있으면 그것부터 씁니다.
등기부등본 API는 큰 개발 조직을 전제로 만들지 않았습니다. 인증은 요청 머리에 API 키 하나를 싣는 방식이고, 변환 API는 세 번, 열람 API는 네 번의 호출로 한 건이 끝납니다. 사내 개발자 한 명이나 외부에 맡긴 개발자가 아래 cURL 예시를 그대로 따라 시작할 수 있습니다.
예를 들어 담보물 목록의 주소로 열람 API를 부르고, 받은 PDF를 변환 API에 보내 엑셀로 정리한 뒤, 그 엑셀을 사내 보고서 양식에 옮기는 흐름을 만들 수 있습니다. 열람 API로 받은 PDF를 변환 API로 정리하면 변환 1건으로 월 변환 한도에서 차감됩니다.
개발 담당자가 없다면 API 없이도 같은 일을 하실 수 있습니다. 주소 목록을 엑셀 양식에 적어 웹 화면에서 한 번에 열람하는 방법은 기업 도입 안내에, 이미 받은 등기 PDF를 올려 엑셀로 받는 방법은 등기 요약(엑셀)에 적었습니다.
처음 연동할 때 함께 확인할 사람이 필요하면 API 연동 지원을 신청하실 수 있습니다. API 키 발급, 개발자 문서 안내, 시험 호출을 함께 하고, 시작한 날부터 30일 동안 연동 질문에 답합니다. 금액은 2,000,000원(부가세 별도)이고 ENTERPRISE를 구독하는 회사만 신청하실 수 있습니다. 귀사 사내 시스템을 만들거나 고치는 개발은 하지 않습니다. 신청과 문의는 문의하기에서 받습니다.
ENTERPRISE 요금제(월 499,000원, 부가세 포함)를 구독하는 계정이 변환 API와 열람 API를 씁니다. 구독하지 않은 계정도 로그인하면 체험 키로 변환 API를 누적 10회까지 호출해 볼 수 있습니다. 열람 API는 체험이 없습니다.
등록한 카드로 나중에 모아 청구하는 후불입니다. 신규 열람은 1건 1,100원, 재열람은 1건 550원이고 모두 부가세 포함입니다. 실패한 열람은 청구하지 않고, 미청구액이 50,000원에 닿거나 한 달이 지나면 합산해 결제합니다. 카드를 등록하지 않으면 열람 요청이 402 오류를 돌려줍니다.
아니요. 열람 API는 주소로 검색한 뒤 후보 목록에서 하나를 고르는 방식입니다. 검색은 무료이고, 후보는 검색 결과의 번호(search_id와 idx)로 지정합니다.
아니요. API로는 등기만 열람합니다. 건축물대장, 토지대장, 지적도, 토지이용계획확인원은 웹 화면에서 발급하실 수 있습니다.
텍스트가 들어 있는 등기 PDF만 변환합니다. 스캔본이나 등기가 아닌 PDF는 결과에서 빠지고 월 변환 한도도 쓰지 않습니다. 변환 API 응답의 excluded 항목이 빠진 파일과 그 이유를 알려 줍니다.
주민등록번호는 항상 가리며 해제할 수 없습니다. 개인 성명은 기본으로 가리고, 계정 설정에서 해제하시면 API 결과에도 같은 설정이 적용됩니다. 올리신 PDF는 변환이 끝나면 바로 지웁니다.
API를 연결하려면 개발자 한 명이나 외부에 맡긴 개발자가 필요합니다. 개발 없이 쓰시려면 엑셀 양식과 웹 화면으로 등기를 일괄 열람하고 엑셀로 정리하실 수 있습니다. 연동을 함께 확인하는 API 연동 지원은 2,000,000원(부가세 별도)이고 ENTERPRISE를 구독하는 회사만 신청합니다.
안 됩니다. API로 받은 등기 데이터는 회원 본인의 업무에만 쓰실 수 있고, 제3자에게 다시 팔거나 배포할 수 없습니다. 열람 API에는 하루 300건 한도가 있습니다.
베이스 URL: https://deungi.cloud · 인증: 모든 요청 헤더에 Authorization: Bearer <API키> (또는 X-API-Key)
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /api/v1/convert | PDF 업로드 → 변환 작업 생성(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/convert | PDF 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로 제공하지 않습니다(등기 열람만). 대장 발급은 웹에서 이용해 주세요.
# 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 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# 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 등기부등본.pdffiles (필수): 등기 PDF. 여러 개 동시 전송 가능.template (선택): 직군 맞춤 템플릿. (빈값)=전체 · agent=공인중개사 · legal=법무사 · auction=경매투자자.asset_id는 고객이 정한 영문·숫자 식별자이며 개인정보를 넣지 마세요. 스캔·사진 PDF는 지원하지 않습니다.Idempotency-Key를 생성하세요. 처리 중 응답을 놓쳤다면 같은 PDF·자산 ID·키로 재시도합니다. 실패가 확정된 작업을 새로 처리하려면 새 키가 필요합니다.registry-pdf.v1 JSON과 엑셀을 30일 안에 다시 받을 수 있습니다. 결과 조회는 다시 차감되지 않으며, 원본 PDF는 처리 후 삭제됩니다.partial·unreadable은 원문 대조가 필요하다는 뜻입니다. 누락 값이나 권리의 법률적 효력을 보장하지 않습니다. 회사 양식 매핑은 표준 응답에 자동 포함되지 않습니다.layout은 현재 계정에 저장한 시트·열 양식만 적용합니다. 이름이 없거나 결과와 맞지 않으면 오류를 반환하며, 임의의 회사 계산식·서식·필드명 변환은 포함하지 않습니다./registry/read 가 402 를 반환합니다. 결제수단 등록하기 →/convert)와 다릅니다. 변환은 플랜 한도에 포함되지만, 등기 열람은 대법원 수수료가 실제로 나가는 건당 과금입니다.여러분의 의견으로 더 좋아집니다. 불편한 점·바라는 기능·버그 무엇이든 알려주세요. 큰 도움이 됩니다.