---
title: "Survey number history (UDR and town survey)"
method: POST
path: "/api/v1/tools/survey_history"
---

# Survey number history (UDR and town survey)

`POST /api/v1/tools/survey_history`

## Request

- Base URL: `https://verified.realestate`
- URL: `https://verified.realestate/api/v1/tools/survey_history`
- Auth: HTTP bearer

Survey number history. direction "old_to_current": an OLD survey number (from a pre-resurvey deed, "R.S. No.", "old S.No", UDR-era number) in, the CURRENT parcels it became out, with their present owners: use for "my deed says survey 186/4 but the patta says 45/4", "what did old survey 59/1 become", "which T.S. number replaced R.S. 1017/114". direction "current_to_old": a current survey number in, the earlier number the register records for it out. Needs the revenue codes, from the free place-name lookup (district_code, taluk_code and village_code for a village; district_code, taluk_code and town_code for a town survey town). Explains the Updating Registry (UDR, 1979 to 1987) renumbering when asked what UDR means. Costs 1 credit per call, waived when nothing is found.

## Request body

- object
  - `direction` 'old_to_current' | 'current_to_old', required: Which way to look
  - `district_code` string, required: Revenue district code, e.g. 35
  - `taluk_code` string, required: Taluk code, e.g. 13
  - `village_code` string: Village code for a rural (A-register) parcel
  - `town_code` string: Town code for a town survey (TSLR) parcel; give village_code OR town_code
  - `old_survey_number` string: For old_to_current: the old number as the deed writes it, e.g. 186/4 or R.S.No 59/1
  - `survey_number` string: For current_to_old: the current survey number, e.g. 45
  - `sub_division` string: For current_to_old: the sub-division, e.g. 4 or 2A1
  - `register` 'rural' | 'urban': Optional: "urban" says village_code is really a town code (the minis cascade passes it this way)

## Response `200`

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

## Other responses

- `401`: No valid credential
- `402`: Not enough credits
- `429`: Rate limit

---

[API](https://skmtc.dev/verified/apis/landlens-tool-api.md) · [All operations](https://skmtc.dev/verified/apis/landlens-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verified/apis/landlens-tool-api/revisions/7923c1c24431?raw)
