토지 소유자

토지 소유자 API는 토지 소유자 연령대, 성별, 지분률, 소유자 변동일자 등을 제공합니다.

요청주소(Endpoint)

• 서비스 URL : https://api.bigvalue.co.kr/api/bv-platform/land-owner
• 요청 주소
  • 소유자명 & 소유자등록번호 : https://api.bigvalue.co.kr/api/bv-platform/land-owner/owner-info
  • 필지 고유번호 : https://api.bigvalue.co.kr/api/bv-platform/land-owner/pnu

호출 시의 주의사항

POST METHOD로만 제공됩니다.

호출 파라미터마다 Endpoint가 다릅니다. 호출 파라미터와 Endpoint가 일치하는지 확인하세요.

호출 시 body size는 1MB를 초과하지 않도록 합니다.

입력부(Input)

소유자 이름 & 소유자 등록번호(주민번호 앞 7자리), 필지 고유번호 중 1개를 선택해 호출합니다.

소유자명 & 소유자등록번호

항목명	형식	필수	설명
owner_name	STRING	Y	소유자 이름
owner_registration_number	STRING	Y	소유자 등록번호 (주민번호 앞 7자리)

{
  "REQUEST_DATA" : [
    {"owner_name" : "홍길동", "owner_registration_number" : "000000-0"},
    {"owner_name" : "홍길롱", "owner_registration_number" : "111111-1"},
    {"owner_name" : "홍길몽", "owner_registration_number" : "222222-2"}
  ]
}

필지 고유번호

항목명	형식	필수	설명
pnu	STRING	Y	필지 고유번호

{
  "REQUEST_DATA" : [
    {"pnu" : "1171010700109130000"},
    {"pnu" : "1171010700109130001"},
    {"pnu" : "1171010700109130002"}
  ]
}

출력부(Output)

항목명	형식	필수	설명
pnu	STRING	Y	필지 고유번호
owner_series_number	NUMBER	Y	소유자순번
legaldong_code	STRING	Y	법정동코드
main_land_number	STRING	N	지번본번
sub_land_number	STRING	N	지번부번
land_number_address	STRING	N	지번주소
owner_name	STRING	N	소유자명
owner_registration_number	STRING	N	소유자등록번호
ownership_division_name	STRING	N	소유자구분명
owner_age_number	NUMBER	N	소유자나이
owner_age_division_name	STRING	N	소유자연령대
owner_gender_name	STRING	N	소유자이름
owner_address	STRING	N	소유자주소
share_rate	STRING	N	지분률
change_date	STRING	N	소유권변동일자
change_reason_name	STRING	N	소유권변동원인
longitude	NUMBER	N	경도
latitude	NUMBER	N	위도

{
  "DATA_COUNT": 1,
  "DATA": [
    {
      "sub_land_number": "104",
      "pnu": "1111010100100520104",
      "owner_series_number": 1,
      "owner_name": "홍길동",
      "ownership_division_name": "개인",
      "owner_age_division_name": "90대",
      "owner_address": "서울특별시 종로구 은천로 93 1203동 1234호",
      "change_date": "9999년 09월 09일",
      "longitude": 126.9684146113,
      "main_land_number": "52",
      "legaldong_code": "1111010100",
      "land_number_address": "서울특별시 종로구 청운동52-104번지",
      "owner_registration_number": "000000-0******",
      "owner_age_number": 99,
      "owner_gender_name": null,
      "share_rate": "1/1",
      "change_reason_name": "주소변경",
      "latitude": 37.5867148438
    }
  ]
}