본문 바로가기
개발가이드등기부등본등기 변동 모니터링

등기 변동 모니터링 API

명세 내보내기
OpenAPI 3.0.3Postman 컬렉션Markdown

부동산·법인의 등기신청사건 처리현황을 매일 확인해 새로 접수된 사건이나 진행 상태 변화를 감지하면 알려줍니다.

POSThttps://apick.app/rest/iros_monitor전체 5개 경로
인증
Bearer 키
요청 형식
form-data
응답
JSON
경로
5개

왜 등기 변동 모니터링인가

등기 변동을 매일 확인하고 알려주는 모니터링

등기부를 열람하지 않고도 부동산·법인의 새 등기 신청과 진행 상태 변화를 매일 확인합니다. 변동이 감지되면 내용을 저장해 알려주고 모니터링을 끝내므로, 감지한 그 확인까지만 과금되고 이후 비용은 없습니다.

도입 효과

  • 매일 1회 자동으로 변동 여부 확인
  • 감지된 변동 내용을 저장해 조회 가능
  • 감지·종료 시점까지만 과금

이런 곳에서 많이 씁니다

  • 부동산 매물·담보 등기 변동 감시
  • 법인 등기 신청 진행 상황 추적
  • 권리 관계 변화 조기 발견
가입하고 API 키 받기API 키 하나로 바로 호출 · 실패한 요청은 과금되지 않습니다

알아둘 점

지원 API 요약

모니터링할 대상 등록과 대상별 상태 조회, 변동 감지 대상 묶음 조회, 전체 목록(무료), 모니터링 종료(무료) API로 나뉩니다. 등록 직후 1회 변동 검사를 바로 수행해 최초 기록을 남기고(status: "monitoring"), 이후 매일 1회씩 자동으로 변동 여부를 확인합니다. 변동이 감지되면 감지된 내용을 저장하고 상태를 changed로 바꿔 모니터링을 끝냅니다(그 이후로는 추가 과금이 없습니다).

Method
API entry point
기능
성공 결과
POST
/rest/iros_monitor
대상 등록(50P, 기준 확인 1회 포함)
target_id·status: "monitoring"
POST
/rest/iros_monitor/status
대상 1건 상태·변동 조회(10P)
status·변동 시 changed
POST
/rest/iros_monitor/changed
변동 감지된 대상 묶음 조회(20P/건)
targets 목록
POST
/rest/iros_monitor/list
내 전체 대상 목록(무료)
targets 목록(변동 정보 없음)
POST
/rest/iros_monitor/terminate
모니터링 종료(무료, 재시작 불가)
status: "terminated"

변동 감지 대상 묶음 조회

본인이 등록한 모니터링 대상 중 변동이 감지된 것만 모아서 돌려줍니다(건당 20P). 변동이 감지된 대상이 없으면 과금 없이 빈 목록이 옵니다.

과금·환급

항목
설명
대상 등록
건당 50P입니다. 등록 즉시 수행하는 기준 확인 1회가 포함됩니다.
매일 자동 확인
모니터링 중인 대상은 매일 1회 변동 여부를 확인하며 확인당 50P입니다.
변동 감지 시
감지된 내용을 저장하고 상태를 changed로 바꿔 모니터링을 끝냅니다. 그 확인까지만 과금되고 이후로는 추가 과금이 없습니다.
대상별 상태 조회
건당 10P입니다.
변동 감지 대상 묶음 조회
건당 20P입니다. 변동 감지 대상이 없으면 과금하지 않습니다.
전체 목록 · 종료
무료(0P)입니다.
확인 실패
매일 확인이 일시적으로 실패하면 그 확인은 과금하지 않고 다음에 다시 확인합니다. 모니터링은 계속됩니다.

요청과 응답

1API 요청
POST/rest/iros_monitor
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 11개 · 필수 1
파라미터
설명
target_typestring필수
대상 유형입니다. realestate(부동산) | corporation(법인).
예시
realestate
duration_daysnumber선택
변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.
예시
365
sido_nmstring조건부
부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
예시
경기도
sgg_nmstring조건부
부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
예시
성남시 분당구
emd_nmstring조건부
부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
예시
정자동
ri_nmstring선택
리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bobnstring조건부
부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
예시
1
bubnstring선택
부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
예시
1
corp_namestring조건부
법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.
corp_reg_nostring조건부
법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).
idempotency_keystring선택
같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.
응답 필드

이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.

2API 요청
POST/rest/iros_monitor/status
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 11개 · 필수 1
파라미터
설명
target_typestring필수
대상 유형입니다. realestate(부동산) | corporation(법인).
예시
입력값
duration_daysnumber선택
변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.
sido_nmstring조건부
부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
sgg_nmstring조건부
부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
emd_nmstring조건부
부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
ri_nmstring선택
리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bobnstring조건부
부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bubnstring선택
부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
corp_namestring조건부
법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.
corp_reg_nostring조건부
법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).
idempotency_keystring선택
같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.
응답 필드

이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.

3API 요청
POST/rest/iros_monitor/changed
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 11개 · 필수 1
파라미터
설명
target_typestring필수
대상 유형입니다. realestate(부동산) | corporation(법인).
예시
입력값
duration_daysnumber선택
변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.
sido_nmstring조건부
부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
sgg_nmstring조건부
부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
emd_nmstring조건부
부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
ri_nmstring선택
리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bobnstring조건부
부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bubnstring선택
부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
corp_namestring조건부
법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.
corp_reg_nostring조건부
법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).
idempotency_keystring선택
같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.
응답 필드

이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.

4API 요청
POST/rest/iros_monitor/list
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 11개 · 필수 1
파라미터
설명
target_typestring필수
대상 유형입니다. realestate(부동산) | corporation(법인).
예시
입력값
duration_daysnumber선택
변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.
sido_nmstring조건부
부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
sgg_nmstring조건부
부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
emd_nmstring조건부
부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
ri_nmstring선택
리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bobnstring조건부
부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bubnstring선택
부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
corp_namestring조건부
법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.
corp_reg_nostring조건부
법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).
idempotency_keystring선택
같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.
응답 필드

이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.

5API 요청
POST/rest/iros_monitor/terminate
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 11개 · 필수 1
파라미터
설명
target_typestring필수
대상 유형입니다. realestate(부동산) | corporation(법인).
예시
입력값
duration_daysnumber선택
변동감지 기간(일)입니다. 1~1000 사이로 지정하고, 생략하면 30일입니다.
sido_nmstring조건부
부동산일 때 필수. 시·도 이름입니다(예: 경기도). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
sgg_nmstring조건부
부동산일 때 필수. 시·군·구 이름입니다(예: 성남시 분당구). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
emd_nmstring조건부
부동산일 때 필수. 읍·면·동 이름입니다(예: 정자동). 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
ri_nmstring선택
리 이름입니다. 읍·면 지역일 때 넣습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bobnstring조건부
부동산일 때 필수. 본번(숫자 1~4자리)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
bubnstring선택
부번(숫자 1~4자리)입니다. 부번이 없으면 생략합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
corp_namestring조건부
법인일 때 corp_reg_no와 둘 중 하나 이상 필수. 법인명입니다.
corp_reg_nostring조건부
법인일 때 corp_name과 둘 중 하나 이상 필수. 법인등록번호입니다(형식 000000-0000000).
idempotency_keystring선택
같은 요청을 두 번 등록·과금하지 않도록 막는 키(8~128자)입니다. 네트워크 오류로 다시 보낼 때 같은 값을 쓰면 추가 과금 없이 기존 대상을 돌려줍니다.
응답 필드

이 경로의 응답 형식은 오른쪽 응답 예시를 확인하세요.

입력 조건·전송 규칙

대상 등록 요청

등록에 성공하면 target_id가 발급되고, 등록 즉시 1회 변동 검사를 수행해 최초 기록을 남깁니다(50P). 이 기준 기록과 비교해 매일 1회씩 새로 접수된 사건이나 진행 상태 변화가 있는지 확인합니다.

전체 목록 · 종료 요청

종료(terminated)되거나 변동이 감지(changed)되거나 기간이 지나(expired) 모니터링이 끝난 대상은 다시 시작할 수 없습니다. 다시 모니터링하려면 대상 등록 API로 새로 등록해 주세요.

응답 처리

HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.

상황
응답
등록 성공
data.target_id·data.status: "monitoring"·data.duration_days
모니터링 중
data.status: "monitoring", check_count·last_check_at·next_check_at로 확인 횟수와 다음 확인 시각을 알 수 있습니다.
변동 감지
data.status: "changed", data.changed(감지 시각·새로 접수된 사건·진행 상태 변화)·data.changed_at
종료
data.status: "terminated"·data.terminated_at
기간 만료
data.status: "expired"

오류 코드

응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

  1. HTTP 상태전송·인증·입력 오류
  2. api.successAPI 처리 여부
  3. data · result업무 결과와 오류 문구
  4. api.cost이번 요청의 과금
업무 실패 응답 data.error
  • 입력값이 맞지 않거나 대상 자료가 없거나 일시적으로 처리하지 못하면 data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.
  • 이때 api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.
  • 입력 오류(400)는 값을 고친 뒤 다시 요청하세요. 408·424는 잠시 후 한 번 다시 시도하고, 같은 입력으로 짧은 간격의 자동 반복은 하지 마세요.
{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 5
  }
}
서비스 코드·조건

대상별 상태 조회 요청

파라미터
타입
필수
설명
target_id
string
필수
등록 응답으로 받은 대상 ID입니다.

오류

오류는 data.error(안내 문구)와 data.error_code로 옵니다.

error_code
의미
대처
IROS_MONITOR_TARGET_TYPE_INVALID
대상 유형이 올바르지 않습니다(400).
target_type 값을 확인합니다.
IROS_MONITOR_TARGET_REQUIRED
대상 정보가 빠졌거나 형식이 다릅니다(400).
주소·지번 또는 법인명·법인등록번호 값을 확인합니다.
IROS_MONITOR_DURATION_OUT_OF_RANGE
기간이 범위를 벗어났습니다(400).
duration_days를 1~1000으로 지정합니다.
IROS_MONITOR_LIMIT_EXCEEDED
모니터링 대상 수가 한도를 넘었습니다.
끝난 대상을 정리하거나 기존 대상을 종료한 뒤 등록합니다.
IROS_MONITOR_POINTS_INSUFFICIENT
포인트가 부족합니다.
충전 후 다시 등록합니다.
IROS_MONITOR_TARGET_NOT_FOUND
대상을 찾을 수 없습니다(404).
target_id를 확인합니다.
IROS_MONITOR_ALREADY_ENDED
이미 종료된 대상입니다.
다시 모니터링하려면 새로 등록합니다.
IROS_MONITOR_TEMPORARILY_UNAVAILABLE
일시적으로 처리할 수 없습니다.
잠시 후 다시 시도합니다.
인증·포인트 오류 result.error 문구
코드
HTTP
의미·조치
유효하지 않은 API키 입니다.
401
Authorization: Bearer 헤더의 인증키를 확인하세요.
허용되지 않은 IP주소 입니다.
401
마이페이지의 허용 IP 설정과 요청 서버 IP를 확인하세요.
비활성화된 계정입니다.
401
계정 이용 상태를 고객지원으로 문의하세요.
사용 가능한 포인트이 부족합니다.
200
HTTP 200이어도 result.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.
무료 포인트로 사용할 수 없는 서비스입니다.
200
최소 1회 결제 후 이용할 수 있습니다. result.error 전체 문구를 그대로 표시하세요.
인증 정보를 확인할 수 없습니다.
424
일시적인 확인 실패입니다. 잠시 후 다시 시도하세요.
폼 입력 오류 error.code
코드
HTTP
의미·조치
FORM_DATA_INVALID
400
필드 이름·값의 타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.
FORM_DATA_FIELD_CONFLICT
400
같은 값과 중첩 경로를 동시에 지정하지 마세요.
MULTIPART_LIMIT_OR_PARSE_ERROR
400·413
boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·이용 조건

기본 요금등록 50P, 매일 확인 50P무료 포인트로는 이용할 수 없으며 최소 1회 결제 후 이용할 수 있습니다.

실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.

연동 팁

  • 요청 예제의 오류 처리 포함 모드는 시간 제한과 업무 실패 판정을 함께 보여줍니다.
  • 인증키는 서버 환경변수에 두고 브라우저·앱에 넣지 마세요.
  • HTTP 성공과 업무 결과를 구분하고, 실패 응답의 오류 문구를 그대로 기록하세요.

개발가이드 검색

API 이름·경로·파라미터·오류 코드로 찾을 수 있습니다.

표시 가격은 기본 단가입니다. 상세 과금 조건은 각 가이드에서 확인하세요.