Sales Watch

Sales Watch: every week, one encumbrance search over a property's survey number and the survey numbers around it (up to 50, same village; on village land each survey is searched whole, every sub-division of it, so 13/2A and 13/2B are one survey 13; on town land the old survey numbers the town survey register prints for the watched plots are searched too), and a WhatsApp digest whenever a sale, mortgage, gift or other deed is newly registered there. action "start" proposes a new watch (approve it to begin; the first search reads the last 90 days). "list" returns the caller's watches, "read" one watch with its deeds, "cancel" stops one. Tamil Nadu only. Listing and reading are free; a new watch is quoted per month (none while a plan still has watches left) as a proposal, run only once the user approves it.

post/api/v1/tools/sales_watch

Request

  • Base URL: https://verified.realestate
  • URL: https://verified.realestate/api/v1/tools/sales_watch
  • Auth: HTTP bearer

Request body

action'list' | 'read' | 'start' | 'cancel'

What to do. Defaults to list.

watch_idinteger

For read and cancel.

district_codestring

Revenue district code (start).

taluk_codestring

Revenue taluk code (start).

village_codestring

Revenue village or town code (start).

register'rural' | 'urban'
ward_codestring

Town survey ward, for an urban parcel.

block_codestring

Town survey block, for an urban parcel.

survey_numberstring

The property's own survey number (start).

sub_divisionstring
aroundinteger

How many of the nearest surveys in the same village to watch as well. Default 10; 0 for the property only.

more_surveysstring[]

Further survey numbers in the same village to watch, e.g. ["114", "115/2"].

labelstring

A name for the watch, e.g. "Our plot at Muttukadu".

polygonobject

Instead of a survey (start): a GeoJSON Polygon drawn around the land, up to 3 sq km. Every plot inside is watched; plots in different villages become one watch each, each priced on its own.

parcelsobject[]

Instead of a survey (start): plots chosen exactly, each {district_code, taluk_code, village_code, survey} (survey like "112/3A"; on village land the whole survey 112 is watched). One watch per village.

Response

The envelope: ok, status, data, credits_charged, balance_after, request_id

Changes

No recorded changes to this operation across all 1 revision of this API.