건축물 소유자

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

요청주소(Endpoint)

서비스 URL : https://api.bigvalue.co.kr/api/bv-platform/building-owner
요청 주소
- 소유자명 & 소유자등록번호 : https://api.bigvalue.co.kr/api/bv-platform/building-owner/owner-info
- 빅밸류 호키 : https://api.bigvalue.co.kr/api/bv-platform/building-owner/ho-key
- 빅밸류 동키 : https://api.bigvalue.co.kr/api/bv-platform/building-owner/dong-key
- 도로명주소 관리번호 : https://api.bigvalue.co.kr/api/bv-platform/building-owner/road-name-address-management-number
- 필지 고유번호 : https://api.bigvalue.co.kr/api/bv-platform/building-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"}
  ]
}

항목명	형식	필수	설명
ho_key	STRING	Y	빅밸류 호키

{
  "REQUEST_DATA" : [
    {"ho_key" : "h00000001"},
    {"ho_key" : "h00000002"},
    {"ho_key" : "h00000003"}
  ]
}

항목명	형식	필수	설명
dong_key	STRING	Y	빅밸류 동키

{
  "REQUEST_DATA" : [
    {"dong_key" : "d00000001"},
    {"dong_key" : "d00000002"},
    {"dong_key" : "d00000003"}
  ]
}

항목명	형식	필수	설명
road_name_address_management_number	STRING	Y	도로명주소 관리번호

{
  "REQUEST_DATA" : [
    {"road_name_address_management_number" : "11110101310001400000100000"},
    {"road_name_address_management_number" : "11110101310001400000200000"},
    {"road_name_address_management_number" : "11110101310001400000300000"}
  ]
}

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

{
  "REQUEST_DATA" : [
    {"pnu" : "1111010100100010000"},
    {"pnu" : "1111010100100020000"},
    {"pnu" : "1111010100100030000"}
  ]
}

출력부(Output)

항목명	형식	필수	설명
ppk	STRING	Y	건축물대장 표제부PK
jpk	STRING	Y	건축물대장 전유부PK
owner_series_number	NUMBER	Y	소유자일련번호
pnu	STRING	Y	필지 고유번호
legaldong_code	STRING	Y	법정동코드
main_land_number	STRING	N	지번본번
sub_land_number	STRING	N	지번부번
land_number_address	STRING	N	지번주소
road_name_address_management_number	STRING	N	도로명주소 관리번호
road_code	STRING	N	도로명코드
main_building_number	STRING	N	건물본번
sub_building_number	STRING	N	건물부번
road_name_address	STRING	N	도로명주소
complex_key	STRING	Y	빅밸류 단지키
complex_name	STRING	N	단지명
dong_key	STRING	Y	빅밸류 동키
dong_name	STRING	N	건물동명
ho_key	STRING	Y	빅밸류 호키
ho_name	STRING	N	건물호명
main_purpose_code	STRING	N	주용도코드
main_purpose_name	STRING	N	주용도명
bv_house_division_name	STRING	N	빅밸류 주택분류명
house_is	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	위도
owner_pnu	STRING	N	소유자 필지 고유번호
owner_road_name_address_management_number	STRING	N	소유자 도로명주소 관리번호

{
  "DATA_COUNT": 1,
  "DATA": [
    {
      "main_land_number": "913",
      "complex_key": "c00487547",
      "bv_house_division_name": "단지형아파트",
      "owner_address": "서울특별시 종로구 은천로 93 1203동 1234호",
      "owner_road_name_address_management_number": "00000000000000000000000000",
      "sub_land_number": null,
      "complex_name": "헬리오시티",
      "house_is": "1",
      "share_rate": "1 /1",
      "land_number_address": "서울특별시 송파구 가락동 913번지",
      "dong_key": "d00553520",
      "owner_name": "홍길동",
      "change_date": "9999.9.9.",
      "ppk": "11710-100542200",
      "road_name_address_management_number": "11710107200501100034500000",
      "dong_name": "112",
      "owner_registration_number": "000000-0******",
      "change_reason_name": "소유권보존",
      "owner_series_number": 1,
      "road_code": "117102005011",
      "ho_key": "h03321363",
      "ownership_division_name": "개인",
      "longitude": 127.1043331356,
      "jpk": "11710-100542291",
      "main_building_number": "345",
      "ho_name": "2404",
      "owner_age_number": 99,
      "latitude": 37.4950085642,
      "pnu": "1171010700109130000",
      "sub_building_number": null,
      "main_purpose_code": "02000",
      "owner_age_division_name": "90대",
      "owner_pnu": "0000000000000000000",
      "legaldong_code": "1171010700",
      "road_name_address": "서울특별시 송파구 송파대로 345",
      "main_purpose_name": "공동주택",
      "owner_gender_name": "남성"
    }
  ]
}

요청주소(Endpoint)​

호출 시의 주의사항​

입력부(Input)​

출력부(Output)​

요청주소(Endpoint)

호출 시의 주의사항

입력부(Input)

출력부(Output)