Order a Property Legal Opinion by API, Tamil Nadu

Example

Request

curl -X POST https://verified.realestate/api/v1/tools/legal_opinion_order \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":12.8421,"lng":80.031,"survey_number":"65","sub_division":"4B","district_code":"03","taluk_code":"14","village_code":"196","village_name":"Kavanoor","rural_urban":"rural"}'

Responsereal answer

{
  "ok": true,
  "status": "proposal",
  "data": {
    "proposal": true,
    "action": "legal_opinion_order",
    "label": "Read the register for survey 65/4B at Kavanoor and list the deeds",
    "params": { "lat": 12.8421, "lng": 80.031, "survey_number": "65", "sub_division": "4B", "...": "..." },
    "cost": 1,
    "source": "One-click legal opinion / step 1 of 2",
    "note": "This is step 1 of 2 and it is NOT the price of the opinion. This 1 credit pays only to read the full-period encumbrance certificate, ... Approving opens the document list: every registered deed the register names, each one deselectable, with the exact total for the opinion itself ... Once you do, the report takes 1 hour to 30 hours and a WhatsApp message arrives when it is ready."
  },
  "credits_quoted": 0,
  "credits_charged": 0,
  "next": { "tool": "approve_action", "arguments": { "action": "legal_opinion_order", "params": { "...": "..." } } }
}

A real quote from the API, trimmed for length.

What it returns

The first call returns the step one quote, with status proposal. The finished opinion is read with legal_opinion.

Field	What it holds
`proposal, action, label`	The quote: what step one does, for which survey and village.
`params`	The parcel exactly as it will be searched. Approve with these unchanged.
`cost`	What step one costs (the register read only).
`note`	What follows: the document list, how the opinion's total is made up, and how long the report takes.
`next`	The approve_action call to make, with the action and params filled in.

Inputs

The JSON body of the POST is the arguments. lat and lng are required by the schema. The survey number and the three revenue codes are needed too, or no quote is made.

Argument	Type	What to send
`lat`required	number	Latitude of the parcel.
`lng`required	number	Longitude of the parcel.
`survey_number`	string	Survey number without the sub-division. resolve_parcel gives it free from the point.
`sub_division`	string	Sub division, e.g. "2A"
`district_code`	string	Revenue district code, from resolve_parcel.
`taluk_code`	string	Revenue taluk code.
`village_code`	string	Revenue village code.
`village_name`	string
`rural_urban`	string: rural, urban	"rural" or "urban", as resolve_parcel returns it.
`revenue_town_code`	string	Urban parcels: revenue town code
`firka_ward_number`	string	Urban parcels: ward
`urban_block_number`	string	Urban parcels: block
`district_name`	string
`taluk_name`	string

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/legal_opinion_order \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":12.8421,"lng":80.031,"survey_number":"65","sub_division":"4B","district_code":"03","taluk_code":"14","village_code":"196","village_name":"Kavanoor","rural_urban":"rural"}'

import os, requests

r = requests.post(
    "https://verified.realestate/api/v1/tools/legal_opinion_order",
    headers={"Authorization": f"Bearer {os.environ['LANDLENS_KEY']}"},
    json={
        "lat": 12.8421,
        "lng": 80.031,
        "survey_number": "65",
        "sub_division": "4B",
        "district_code": "03",
        "taluk_code": "14",
        "village_code": "196",
        "village_name": "Kavanoor",
        "rural_urban": "rural"
    },
    timeout=30,
)
body = r.json()
print(body["status"], body["credits_charged"], body["data"])

const res = await fetch("https://verified.realestate/api/v1/tools/legal_opinion_order", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LANDLENS_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "lat": 12.8421,
    "lng": 80.031,
    "survey_number": "65",
    "sub_division": "4B",
    "district_code": "03",
    "taluk_code": "14",
    "village_code": "196",
    "village_name": "Kavanoor",
    "rural_urban": "rural"
  }),
});
const body = await res.json();
console.log(body.status, body.credits_charged, body.data);

I want a full legal opinion on survey 65/4B in Kavanoor village, Kundrathur taluk. I do not have the documents.

Your AI resolves the parcel, shows you the quote for the register read, and orders nothing until you say yes.

Responses

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

status	What it means
`proposal`	The step one quote. Nothing is charged.
`not_found`	No location, or the survey number and revenue codes are missing. error says to resolve the parcel first.
`invalid_args`	From approve_action today: the second step (the document list and the opinion's total) is approved in LandLens, so approving this quote over the API is refused. See limits.

Where the data comes from

Register

The registration department's encumbrance index for the parcel's full period, certified copies of the deeds it names, the revenue records, the CERSAI register, court and revenue court searches and the LandLens land checks, read together into one opinion.

Coverage

Any Tamil Nadu parcel with revenue codes and a survey number, village or town survey.

How current

Live. The encumbrance certificate is always read fresh for an opinion, so a deed registered since any earlier check is not missed.

How we read it

Two approvals. The first pays only for the register read and returns the list of registered deeds, each one deselectable, with the exact total for the opinion. Nothing more is charged until that total is approved; the copies, checks and opinion then run unattended.

Who uses it

Banks and NBFCs

Commission a title opinion on a parcel at login, from its location, without waiting for the borrower's documents.

Land aggregators

Get an opinion on a parcel you are negotiating for before the seller hands over the deeds.

Buyers

Have the whole registered history of a plot read, copied and opined on, from a map pin.

Limits and good practice

The order is completed in LandLens. Approving this quote over the API answers invalid_args, because the step that approves the document list and the opinion's total needs the list the LandLens screen issues. Use legal_opinion_project to order an opinion end to end over the API from your own documents.
Resolve the parcel first. Without the survey number and revenue codes no quote is made.
The quote is for the register read only. The opinion is priced on the next step, by the deeds you keep.
An opinion reads what is registered and what the checks return. What it lists as needing manual verification has not been verified.

Pricing

1 credit on approval

Step one, the register read, costs 1 credit. The opinion is then quoted in full (a base price, more for each survey number beyond three, and a certified copy per deed kept) and nothing more is charged until that total is approved. 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

Can I order a property legal opinion by API?

You can start one: this returns the quote for reading the parcel's register. The second approval, of the document list and total, is completed in LandLens. To order end to end over the API, use legal_opinion_project with the documents you hold.

How long does the opinion take?

One to thirty hours once the total is approved, depending on how many certified copies are fetched.

What does it cost?

The register read costs 1 credit. The opinion's own total is shown, itemised, before you approve it.

How do I read the finished opinion?

With legal_opinion: list your opinions, then read one by its project id.