EC Availability API: which office holds a village, and since when

Example

curl -X POST https://verified.realestate/api/v1/tools/ec_availability \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"village":"Kavanoor"}'

{
  "ok": true,
  "status": "ok",
  "data": {
    "found": true,
    "villages": [
      {
        "village": "KAVANOOR",
        "ranges": [
          { "sro": "Tambaram Joint 1", "sro_code": "20053:1", "from": "01-Jan-1975", "to": "10-Aug-1986", "current": false }
        ]
      },
      {
        "village": "Kavanoor",
        "ranges": [
          { "sro": "Kunrathur", "sro_code": "20061:1", "from": "01-Sep-1989", "current": true },
          { "sro": "Rajasinga mangalam", "sro_code": "20301:1", "from": "01-Jan-1987", "current": true },
          { "sro": "Arcot", "sro_code": "20602:1", "from": "01-Jun-2003", "current": true },
          { "sro": "Pallikonda", "sro_code": "20647:1", "from": "01-Jan-1975", "to": "14-Apr-1999", "current": false }
        ]
      }
    ],
    "note": "Each range shows which SRO held the village for those dates; an EC covering years across ranges may need pulls at more than one SRO. The interface renders the timeline; answer whether the years the user needs are covered."
  },
  "credits_charged": 0
}

A real answer from the API. Four of the twelve periods are left out for length; the rest are as returned. Several different villages in Tamil Nadu are called Kavanoor, and their offices come back together.

What it returns

One call, one answer. found is false (status not_found) when no registration village carries a name like the one sent.

Inputs

The JSON body of the POST is the arguments.

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/ec_availability \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"village":"Kavanoor"}'

import os, requests

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

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

I need an EC for my land in Kavanoor, Kundrathur taluk, from 1980. Which sub registrar office held the village back then?

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

• The match is by name only. Many Tamil Nadu villages share a name, and the offices of all of them come back together. Pick the ranges by the office you expect for the district, or confirm with sro_lookup on a map point.
• At most four matching village names are returned.
• The registration spelling can differ from the revenue spelling (for example Kunrathur and Kundrathur). If nothing matches, look the village up in sro_directory first.
• A period says where the records are held, not that any deed was registered in it.

Pricing

Questions

Related APIs