Composite Value API: Tamil Nadu flat guideline rate per sq ft

Example

Request

curl -X POST https://verified.realestate/api/v1/tools/composite_value \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"street":"Rajalakshmi Nagar","village":"Velachery"}'

Responsereal answer

{
  "ok": true,
  "status": "ok",
  "data": {
    "found": true,
    "street": "RAJALAKSHMI NAGAR",
    "village": "Velachery",
    "sro": "Velacheri",
    "zone": "Chennai",
    "rate_per_sqft": 7500,
    "rate_year": "2024 revision",
    "context": {
      "village": { "min": 6000, "max": 15000, "streets": 715 },
      "sro": { "min": 5500, "max": 15000, "streets": 1234 },
      "zone": { "min": 300, "max": 30000, "streets": 13342 }
    },
    "matches": [
      { "street": "RAJALAKSHMI NAGAR", "village": "Velachery", "rate_per_sqft": 7500 },
      { "street": "RAJALAKSHMI NAGAR 1ST MAIN ROAD", "village": "Velachery", "rate_per_sqft": 7500 },
      { "street": "RAJALAKSHMI NAGAR 2ND MAIN ROAD", "village": "Velachery", "rate_per_sqft": 7500 }
    ]
  },
  "credits_charged": 1
}

A real answer from the API. Nine of the twelve matches and the closing note are left out for length.

What it returns

One call, one answer. found is false (status not_found, nothing charged) when no street matches.

Field	What it holds
`street, village, sro, zone`	The best matching register entry.
`rate_per_sqft`	Its composite rate in rupees per square foot of built-up area.
`rate_year`	The revision the rate belongs to.
`context.village, context.sro, context.zone`	The lowest and highest composite rate in each, with the number of streets rated.
`matches[]`	Up to 12 streets that matched, each with village and rate_per_sqft. Check the right one when there are several.

Inputs

The JSON body of the POST is the arguments. Send a street, a village, or both. Both narrow the match best.

Argument	Type	What to send
`street`	string	The street name, or part of it, e.g. Rajalakshmi Nagar.
`village`	string	The village or locality as the registration department names it, e.g. Velachery.
`sro`	string	SRO name, if known

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/composite_value \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"street":"Rajalakshmi Nagar","village":"Velachery"}'

import os, requests

r = requests.post(
    "https://verified.realestate/api/v1/tools/composite_value",
    headers={"Authorization": f"Bearer {os.environ['LANDLENS_KEY']}"},
    json={
        "street": "Rajalakshmi Nagar",
        "village": "Velachery"
    },
    timeout=20,
)
body = r.json()
print(body["status"], body["credits_charged"], body["data"])

const res = await fetch("https://verified.realestate/api/v1/tools/composite_value", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LANDLENS_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "street": "Rajalakshmi Nagar",
    "village": "Velachery"
  }),
});
const body = await res.json();
console.log(body.status, body.credits_charged, body.data);

What is the composite guideline value for a flat on Rajalakshmi Nagar 3rd Main Road, Velachery? Is that high for the area?

Your AI finds the street's composite rate and compares it with the rest of Velachery.

Responses

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

status	What it means
`ok`	A street matched. Charged.
`not_found`	No street matched, or neither street nor village was sent. Nothing is charged.
`insufficient_credits`	HTTP 402: the balance does not cover the call, with the credits needed and your balance.

Where the data comes from

Register

The composite value register of the Tamil Nadu Registration Department: the guideline rate for built-up flats and buildings, published street by street.

Coverage

17,009 street entries under 196 sub registrar offices, across all 11 registration zones of Tamil Nadu. The register covers the streets the department rates for buildings, which are mostly in towns and cities.

How current

The 2024 revision, reviewed once a year against the department's published register.

How we read it

The street is matched with dots, spaces and punctuation ignored (G.N. Chetty Road finds G N CHETTY ROAD). The exact name ranks first, then the plainest name, then the highest rate. Up to 12 matches come back so the right one can be chosen.

Who uses it

Flat buyers and builders

Work out the guideline value of a flat (rate times built-up area) before the stamp duty is quoted.

Lenders

Check that a flat's registered value is not below the composite rate for its street.

Property portals

Show the composite rate beside a flat listing's price per square foot.

Limits and good practice

For built-up flats and buildings only. Land is rated by the guideline value register; use guideline_value.
Rated by street. A street the department does not list for buildings returns not_found; try the nearest main road.
A partial name can match many streets. Read matches and confirm the right one.
The rate is per square foot of built-up area, not of the land share.

Pricing

1 credit per answer

Each call costs 1 credit, and nothing when no street matches. Credits come from the same LandLens wallet as the chat and the minis. How billing works.

Calling at volume?

For thousands of calls a month, a portfolio sweep or a platform built on these registers, we quote a customised bulk price, with invoicing to match.

WhatsApp 99961 29996

Questions

Is there an API for the composite value of a flat in Tamil Nadu?

Yes, this one. It returns the composite guideline rate per square foot for the flat's street from the registration department's register.

What is the difference between composite value and guideline value?

The guideline value is the rate for land. The composite value is the rate for a built-up flat or building, land share and construction together, per square foot of built-up area.

How do I get the guideline value of my flat?

Multiply rate_per_sqft by the flat's built-up area. That is the floor the sub registrar applies; the deed registers at the higher of it and the price.

Which areas are covered?

All 11 registration zones of Tamil Nadu, 17,009 streets in all, mostly in towns and cities where flats are built.