Tamil Nadu FMB Village Map API with survey numbers

Example

Request

curl -X POST https://verified.realestate/api/v1/tools/village_map \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"district_code":"03","taluk_code":"14","village_code":"196"}'

Responsereal answer

{
  "ok": true,
  "status": "ok",
  "data": {
    "found": true,
    "village": "Kavanoor",
    "taluk": "Kundrathur",
    "district": "Kancheepuram",
    "parcel_count": 3745,
    "survey_count": 256,
    "centre": {
      "lat": 12.8347,
      "lng": 80.026111
    },
    "bounds": [
      [
        12.822037,
        80.019191
      ],
      [
        12.847363,
        80.03303
      ]
    ],
    "parcels_url": "https://verified.realestate/dashboard/utility/village-map/parcels?d=03&t=14&v=196",
    "page_url": "https://verified.realestate/dashboard/utility/village-map",
    "source": "State cadastral boundary layer (FMB), one outline per survey sub-division",
    "note": "Each outline is one survey sub-division as the state cadastral boundary layer draws it. Give the parcel and survey counts and offer the map link; for one survey's measured sketch offer the FMB sketch, and for who holds a survey the land record."
  },
  "credits_charged": 0
}

A real answer from the API (22 Oct 2026), run on the test site, with its links shown as the live API gives them.

What it returns

One call, one village. The outlines themselves are at parcels_url. found is false (status not_found) when the layer holds no outlines for the village.

Field	What it holds
`parcel_count, survey_count`	How many sub-division outlines and how many distinct survey numbers the village map holds.
`village, taluk, district`	The village's names.
`centre, bounds`	The middle of the village and its south-west and north-east corners, as latitude and longitude, to frame a map.
`parcels_url`	A public link to the outlines as JSON: parcels is a list of [survey, sub-division, [[lat, lng], ...]]. No key is needed to open it.
`page_url`	The village map page, where the same map can be opened in a browser.
`source`	Which layer the outlines come from.

Inputs

The JSON body of the POST is the arguments. The three codes are required. resolve_revenue_codes or revenue_directory give them at no charge.

Argument	Type	What to send
`district_code`required	string	Revenue district code, e.g. 03
`taluk_code`required	string	Revenue taluk code, e.g. 01
`village_code`required	string	Revenue village code, e.g. 121
`register`	string: rural, urban	"rural" for a village. "urban" is refused: a town has no village map.

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/village_map \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"district_code":"03","taluk_code":"14","village_code":"196"}'

import os, requests

r = requests.post(
    "https://verified.realestate/api/v1/tools/village_map",
    headers={"Authorization": f"Bearer {os.environ['LANDLENS_KEY']}"},
    json={
        "district_code": "03",
        "taluk_code": "14",
        "village_code": "196"
    },
    timeout=30,
)
body = r.json()
print(body["status"], body["credits_charged"], body["data"])

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

Show me the village map of Kavanoor in Kundrathur taluk with its survey numbers, and where survey 65 is.

Your AI finds the village codes and opens the village map. It is free.

Responses

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

status	What it means
`ok`	The village map was found.
`not_found`	The layer holds no outlines for the village (town survey land, or a village not digitised), the codes are unknown, or register was urban.
`invalid_args`	A code is missing.
`free_limit_reached`	The account has used its free calls for the hour or the day. retry_after says how many seconds to wait; paid calls keep working.

Where the data comes from

Register

The Tamil Nadu cadastral boundary layer published by the state GIS: one outline per survey sub-division, drawn from the Field Measurement Book sketches.

Coverage

Every revenue village whose map the state has digitised. Town survey land is kept by ward and block and has no village map.

How current

Read from our copy of the state cadastral layer, refreshed from the state GIS. Outlines change only when the survey department redraws them.

How we read it

All outlines filed under the village's codes are read and counted. A village with no outlines is answered as not found, with the reason, never as an empty map.

Who uses it

Surveyors and engineers

Draw a whole village's survey grid before a site visit, and see which numbers surround the one on the deed.

Land aggregators

Lay out every survey of a village to plan which parcels to approach.

Map applications

Overlay the cadastral outlines of a village on your own base map from one link.

Limits and good practice

The outlines are the state's digitised map, not a ground survey. For one survey's measured sketch use fmb_sketch.
Town survey land has no village map. Use the ward and block with the town survey calls instead.
A large village can hold several thousand outlines; parcels_url returns them all at once.

Pricing

Free

The village map costs nothing. Free calls have their own allowance per hour and per day. Credits come from the same LandLens wallet as the chat and the minis. How billing works.

Calling at volume?

Free calls have an hourly and daily allowance. For more than that, or a platform built on these registers, we set up limits and a plan to match.

WhatsApp 99961 29996