등기부등본 PDF 파서

등기부등본(등기사항전부증명서) PDF 파일을 업로드하면 표제부·갑구·을구 전체를 구조화된 JSON으로 변환합니다.

지원 문서 유형

토지

토지 등기부등본. 지목·면적·토지의 표시·매매목록을 포함합니다.

건물

일반 건물 등기부등본. 층별 면적·구조·용도를 포함합니다.

집합건물

아파트·오피스텔 등 집합건물. 전유부분·대지권 비율을 포함합니다.

엔드포인트

POST /v1/document-parser/registry

문서 유형(토지/건물/집합건물)은 PDF 내용에서 자동 판별됩니다. 별도 지정이 필요 없습니다.

요청

curl -X POST https://prod.fn.imprun.dev/v1/document-parser/registry \
  -H "Authorization: Bearer {keyId}.{secret}" \
  -F "file=@등기부등본.pdf"

파라미터	타입	필수	설명
`file`	file	O	등기부등본 PDF 파일 (최대 50MB)

응답

{
  "document_type": "registry",
  "parser_version": "1.4.0",
  "parsed_at": "2026-02-23T12:00:00+00:00",
  "data": { ... },
  "confidence": {
    "overall": 91,
    "level": "높음",
    "details": { ... }
  }
}

필드	타입	설명
`document_type`	`string`	항상 `"registry"`
`parser_version`	`string`	파서 버전 (현재 `"1.4.0"`)
`parsed_at`	`string`	파싱 수행 시각 (ISO 8601)
`data`	`object`	파싱 결과 본문. RegistryData 스키마 참조
`confidence`	`object`	파싱 신뢰도 점수

에러

HTTP 코드	에러	설명
`400`	잘못된 요청	`file` 파라미터 누락, 지원하지 않는 문서 타입
`401`	인증 실패	API 키가 없거나 유효하지 않음
`403`	접근 거부	잔액 부족 또는 계정 정지
`422`	파싱 실패	PDF에서 등기부등본 내용을 인식할 수 없음

RegistryData

data 필드에 담기는 최상위 구조입니다. 문서 유형에 따라 title_info 내부 필드가 달라집니다.

{
  "unique_number": "1184-2004-006616",
  "property_type": "land",
  "property_address": "전라남도 나주시 빛가람동 42-2",
  "title_info": { ... },
  "section_a": [ ... ],
  "section_b": [ ... ],
  "trade_lists": [ ... ],
  "major_summary": { ... },
  "jurisdiction": "광주지방법원 나주등기소",
  "viewed_at": "2025년 04월 01일 13시 06분 16초",
  "section_a_count": 11,
  "section_b_count": 12,
  "active_section_a_count": 5,
  "active_section_b_count": 3
}

필드	타입	설명
`unique_number`	`string`	고유번호 (`"NNNN-YYYY-NNNNNN"`)
`property_type`	`string`	`"land"` \| `"building"` \| `"aggregate_building"`
`property_address`	`string`	부동산 소재지 주소
`title_info`	`object`	표제부 — 부동산 물리 정보
`section_a`	`array`	갑구 — 소유권에 관한 사항
`section_b`	`array`	을구 — 소유권 이외의 권리
`trade_lists`	`array`	매매목록 — 토지 복수 필지 거래 시
`major_summary`	`object \| null`	주요등기사항 요약
`jurisdiction`	`string \| null`	관할등기소
`viewed_at`	`string \| null`	열람일시
`issued_at`	`string \| null`	발행일시
`section_a_count`	`integer`	갑구 전체 항목 수
`section_b_count`	`integer`	을구 전체 항목 수
`active_section_a_count`	`integer`	갑구 유효(비말소) 항목 수
`active_section_b_count`	`integer`	을구 유효(비말소) 항목 수

property_type에 따라 title_info 내부 필드가 달라집니다. 유형별 상세 스키마는 각 문서 유형 페이지를 참고하세요.

표제부 (title_info)

부동산의 물리적 정보를 담습니다. property_type에 따라 사용되는 필드가 다릅니다.

공통 필드

필드	타입	설명
`property_type`	`string`	부동산 유형
`address`	`string`	소재지 주소 (지번)

유형별 고유 필드

필드	토지	건물	집합건물	설명
`land_type`	O	-	-	지목 (전, 답, 대 등)
`land_area`	O	-	-	토지 면적
`land_entries`	O	-	-	토지의 표시 항목
`road_address`	-	O	O	도로명주소
`structure`	-	O	O	건물 구조
`roof_type`	-	O	O	지붕 종류
`floors`	-	O	O	지상 층수
`building_type`	-	O	O	건물 용도
`areas`	-	O	O	층별 면적 목록
`total_floor_area`	-	O	O	연면적 (㎡)
`building_entries`	-	O	O	건물의 표시 항목
`building_name`	-	-	O	건물명
`exclusive_area`	-	-	O	전용면적 (㎡)
`land_right_ratio`	-	-	O	대지권 비율
`exclusive_part_entries`	-	-	O	전유부분 항목
`land_right_entries`	-	-	O	대지권 토지 항목
`land_right_ratio_entries`	-	-	O	대지권 비율 항목

갑구 (section_a)

소유권에 관한 사항. 소유권이전, 가압류, 경매, 압류 등 소유권 관련 등기를 포함합니다.

{
  "rank_number": "3",
  "purposes": [
    {
      "type": "소유권이전",
      "target_rank": null,
      "target_type": null,
      "target_owner": null
    }
  ],
  "receipt": {
    "date": "2007년 09월 11일",
    "number": "14543호"
  },
  "cause": {
    "text": "매매",
    "date": "2007년 08월 30일"
  },
  "details": {
    "owners": [
      {
        "name": "홍길동",
        "resident_number": "800101-*******",
        "address": "서울특별시 강남구 역삼동 123-4",
        "share": null,
        "role": "소유자"
      }
    ],
    "creditors": [],
    "claim_amount": null,
    "trade_list_number": null,
    "remarks": null
  },
  "is_cancelled": false,
  "cancelled_by_rank": null,
  "cancellation_date": null,
  "cancellation_cause": null
}

갑구 항목 필드

필드	타입	설명
`rank_number`	`string`	순위번호. 주등기: `"1"`, 부기: `"1-1"`
`purposes`	`array`	등기목적
`receipt`	`object`	접수 정보
`cause`	`object`	등기원인
`details`	`object`	갑구 상세 — 아래 표 참조
`is_cancelled`	`boolean`	말소 여부
`cancelled_by_rank`	`string \| null`	말소시킨 등기의 순위번호
`cancellation_date`	`string \| null`	말소 날짜
`cancellation_cause`	`string \| null`	말소 원인

갑구 details 필드

필드	타입	설명
`owners`	`array`	소유자 목록. 소유권이전 시
`creditors`	`array`	채권자 목록. 가압류·경매 시
`claim_amount`	`integer \| null`	청구금액 (원)
`disposition_authority`	`string \| null`	처분청 (체납 압류 시)
`trade_list_number`	`string \| null`	매매목록 번호
`remarks`	`string \| null`	기타사항

을구 (section_b)

소유권 이외의 권리에 관한 사항. 근저당권, 전세권, 임차권, 지상권 등을 포함합니다.

{
  "rank_number": "1",
  "purposes": [
    {
      "type": "근저당권설정",
      "target_rank": null,
      "target_type": null,
      "target_owner": null
    }
  ],
  "receipt": {
    "date": "2007년 09월 11일",
    "number": "14544호"
  },
  "cause": {
    "text": "설정계약",
    "date": "2007년 09월 11일"
  },
  "details": {
    "max_claim_amount": 120000000,
    "bond_amount": null,
    "debtors": [
      { "name": "홍길동", "resident_number": "800101-*******", "address": "서울특별시 강남구 역삼동 123-4" }
    ],
    "mortgagees": [
      { "name": "주식회사 국민은행", "resident_number": "110111-0032157", "address": "서울특별시 중구 을지로2가" }
    ],
    "collateral_list": "제2007-194호",
    "remarks": null
  },
  "is_cancelled": false
}

을구 항목 필드

갑구와 동일한 rank_number, purposes, receipt, cause, 말소 관련 필드를 가지며, details가 을구 전용 구조입니다.

을구 details 필드

등기 유형에 따라 해당하는 필드만 값이 설정됩니다. 근저당권:

필드	타입	설명
`max_claim_amount`	`integer \| null`	채권최고액 (원)
`bond_amount`	`integer \| null`	채권액 (원)
`debtors`	`array`	채무자 목록 (OwnerInfo)
`mortgagees`	`array`	근저당권자 목록 (CreditorInfo)

임차권·전세권:

필드	타입	설명
`deposit_amount`	`integer \| null`	보증금/전세금 (원)
`monthly_rent`	`integer \| null`	차임/월세 (원)
`lessee`	`object \| null`	임차인 (name, resident_number, address)
`lease_area`	`string \| null`	임차 면적
`lease_term`	`object \| null`	기간 (contract_date, fixed_date 등)

지상권:

필드	타입	설명
`purpose`	`string \| null`	지상권 목적
`scope`	`string \| null`	지상권 범위
`duration`	`string \| null`	존속기간
`land_rent`	`string \| null`	지료

공동담보:

필드	타입	설명
`collateral_list`	`string \| null`	공동담보목록 번호
`collateral_items`	`array \| null`	인라인 공동담보 항목

공통 구조체

등기목적 (purposes)

등기목적 컬럼에서 추출됩니다. 단일 등기는 배열에 1개, 복합말소는 N개 원소를 가집니다.

필드	타입	설명
`type`	`string`	등기유형 (예: `"소유권이전"`, `"근저당권설정등기말소"`)
`target_rank`	`string \| null`	대상 순위번호 (부기등기 시)
`target_type`	`string \| null`	대상 등기유형 (을구 부기 시)
`target_owner`	`string \| null`	대상 소유자명 (갑구 부기 시)

말소 부기등기 예시

순위번호 5번의 경매등기를 말소하는 경우:

{
  "purposes": [
    {
      "type": "임의경매개시결정등기말소",
      "target_rank": "5",
      "target_type": null,
      "target_owner": null
    }
  ]
}

복합말소 예시

1번 근저당권과 2번 지상권을 동시에 말소:

{
  "purposes": [
    { "type": "근저당권설정등기말소", "target_rank": "1" },
    { "type": "지상권설정등기말소", "target_rank": "2" }
  ]
}

접수 (receipt)

필드	타입	설명
`date`	`string`	접수일자 (예: `"2007년 09월 11일"`)
`number`	`string`	접수번호 (예: `"14543호"`)

등기원인 (cause)

필드	타입	설명
`text`	`string`	등기원인 (예: `"매매"`, `"상속"`, `"설정계약"`)
`date`	`string \| null`	등기원인 발생일

소유자 (OwnerInfo)

갑구 details.owners, 을구 details.debtors에 사용됩니다.

필드	타입	설명
`name`	`string`	성명 또는 법인명
`resident_number`	`string \| null`	주민/법인등록번호 (마스킹됨)
`address`	`string \| null`	주소
`share`	`string \| null`	지분 (공유 시, 예: `"3분의 1"`)
`role`	`string \| null`	역할: `"소유자"`, `"공유자"`, `"수탁자"` 등

채권자 (CreditorInfo)

갑구 details.creditors, 을구 details.mortgagees에 사용됩니다.

필드	타입	설명
`name`	`string`	성명 또는 법인명
`resident_number`	`string \| null`	주민/법인/부동산등기용 등록번호
`address`	`string \| null`	주소

매매목록

토지 문서에서 복수 필지를 한 거래로 처리할 때 사용됩니다. 건물·집합건물에서는 보통 빈 배열입니다.

{
  "list_number": "2016-553",
  "trade_amount": 85000000,
  "items": [
    {
      "serial_number": "1",
      "property_description": "[토지] 경상북도 문경시 농암면 내서리 733",
      "rank_number": "8",
      "registration_cause": "매매",
      "correction_cause": ""
    }
  ]
}

갑구 항목의 details.trade_list_number와 trade_lists[].list_number로 연결됩니다.

주요등기사항 요약

등기소가 생성한 요약입니다. 현재 유효한 소유자와 주요 권리사항을 한눈에 보여줍니다.

{
  "major_summary": {
    "property_type": "토지",
    "address": "전라남도 나주시 빛가람동 42-2 전 714㎡",
    "owners": [
      {
        "name": "홍길동 (소유자)",
        "resident_number": "800101-*******",
        "final_share": "단독소유",
        "rank_number": "3"
      }
    ],
    "rights": [
      {
        "rank_number": "1",
        "registration_purpose": "근저당권설정",
        "receipt_date": "2007년09월11일",
        "receipt_number": "제14544호",
        "creditor": "주식회사 국민은행",
        "max_claim_amount": 120000000
      }
    ]
  }
}

주요등기사항 요약은 참고용이며 법적 효력이 없습니다. 정확한 권리관계는 갑구·을구 원본 데이터를 확인하세요.

개요

PDF 파싱

등기부등본 PDF 파서

지원 문서 유형

토지

건물

집합건물

엔드포인트

요청

응답

에러

RegistryData

표제부 (title_info)

공통 필드

유형별 고유 필드

갑구 (section_a)

갑구 항목 필드

갑구 details 필드

을구 (section_b)

을구 항목 필드

을구 details 필드

공통 구조체

등기목적 (purposes)

접수 (receipt)

등기원인 (cause)

소유자 (OwnerInfo)

채권자 (CreditorInfo)

매매목록

주요등기사항 요약

개요

PDF 파싱

​지원 문서 유형

토지

건물

집합건물

​엔드포인트

​요청

​응답

​에러

​RegistryData

​표제부 (title_info)

​공통 필드

​유형별 고유 필드

​갑구 (section_a)

​갑구 항목 필드

​갑구 details 필드

​을구 (section_b)

​을구 항목 필드

​을구 details 필드

​공통 구조체

​등기목적 (purposes)

​접수 (receipt)

​등기원인 (cause)

​소유자 (OwnerInfo)

​채권자 (CreditorInfo)

​매매목록

​주요등기사항 요약

지원 문서 유형

엔드포인트

요청

응답

에러

RegistryData

표제부 (title_info)

공통 필드

유형별 고유 필드

갑구 (section_a)

갑구 항목 필드

갑구 details 필드

을구 (section_b)

을구 항목 필드

을구 details 필드

공통 구조체

등기목적 (purposes)

접수 (receipt)

등기원인 (cause)

소유자 (OwnerInfo)

채권자 (CreditorInfo)

매매목록

주요등기사항 요약