Guideline Value History API for Tamil Nadu

Example

curl -X POST https://verified.realestate/api/v1/tools/guideline_history \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"village":"Velachery","sro":"Velacheri","street":"Adhinarayana Puram 1st street","classification":"Residential Class II Type - III","current_value":3850}'

{
  "ok": true,
  "status": "ok",
  "data": {
    "found": true,
    "zone": "Chennai",
    "sro": "Velacheri",
    "village": "Velachery",
    "street": "Adhinarayana Puram 1st street",
    "classification": "Residential Class II Type - III",
    "unit": "per unit (as registered)",
    "series": [
      { "year": 2024, "value": 3850 },
      { "year": 2023, "value": 3500 },
      { "year": 2017, "value": 2345 },
      { "year": 2012, "value": 3500 },
      { "year": 2007, "value": 1500 }
    ],
    "latest_value": 3850,
    "oldest_value": 1500
  },
  "credits_charged": 0
}

A real answer from the API. This street has no rate recorded for 2003 or 2002, so those revisions are left out.

What it returns

One call, one series. found is false (status not_found) when no street history can be pinned to the parcel; the answer says so plainly, and the current rate must not be passed off as a trend.

Inputs

The JSON body of the POST is the arguments. Send the same lat and lng you used for guideline_value and the street is found for you. Or send what guideline_value returned: village, sro, classification and current_value, and the street when there is one.

Code

Set LANDLENS_KEY to your key. In an AI app, connect https://verified.realestate/mcp once and ask in plain words instead. In Postman, download this API's collection, import it (File, Import) and set apiKey.

curl -X POST https://verified.realestate/api/v1/tools/guideline_history \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"village":"Velachery","sro":"Velacheri","street":"Adhinarayana Puram 1st street","classification":"Residential Class II Type - III","current_value":3850}'

import os, requests

r = requests.post(
    "https://verified.realestate/api/v1/tools/guideline_history",
    headers={"Authorization": f"Bearer {os.environ['LANDLENS_KEY']}"},
    json={
        "village": "Velachery",
        "sro": "Velacheri",
        "street": "Adhinarayana Puram 1st street",
        "classification": "Residential Class II Type - III",
        "current_value": 3850
    },
    timeout=20,
)
body = r.json()
print(body["status"], body["credits_charged"], body["data"])

const res = await fetch("https://verified.realestate/api/v1/tools/guideline_history", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LANDLENS_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "village": "Velachery",
    "sro": "Velacheri",
    "street": "Adhinarayana Puram 1st street",
    "classification": "Residential Class II Type - III",
    "current_value": 3850
  }),
});
const body = await res.json();
console.log(body.status, body.credits_charged, body.data);

How has the guideline value of Adhinarayana Puram 1st Street in Velachery changed since 2007?

Responses

Every answer has the same envelope. What status can say for this call:

Where the data comes from

Who uses it

Limits and good practice

• Seven revisions only: 2002, 2003, 2007, 2012, 2017, 2023 and 2024. Rates between revisions are not interpolated.
• The 2017 revision cut rates across Tamil Nadu, so a dip in that year is the revision, not a fall in the market.
• This is the street register. Village land rated survey by survey often has no street history.
• A history is pinned to one street or not given at all. A not_found here does not mean the parcel has no current rate.

Pricing

Questions

Related APIs