Land Case Law Search API, Madras High Court

What it returns

One call, one answer. found is false (status not_found) when no judgment in the set matches, and the answer says so rather than offering a remembered case.

Field	What it holds
`results[]`	Up to ten judgments, most relevant first, one passage each.
`case, court, decided, outcome, judge`	The cause title, the court (with the Madurai Bench named), the decision date, how it was disposed of, and the judge.
`passage, page, citation_url`	The passage that matched (up to 1,200 characters), its page, and a link to the judgment PDF opened at that page.
`binding`	On Supreme Court results: that the ruling binds every court in India, including the Madras High Court.
`count, corpus, note`	How many judgments came back, what the set covers, and how to cite them without stating one judgment as the rule.

Inputs

The JSON body of the POST is the arguments.

Argument	Type	What to send
`query`required	string	The legal question or fact pattern in English, e.g. "Tahsildar refused patta transfer because the land is natham".
`from_year`	integer	Earliest decision year, e.g. 2020, when the question is about the current position.
`court`	string: Supreme Court, Madras High Court	"Supreme Court" or "Madras High Court" to search one court. Both are searched by default.
`bench`	string: Chennai, Madurai	"Chennai" or "Madurai" to search one bench of the High Court. Setting it leaves the Supreme Court out.

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

import os, requests

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

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

Has the Madras High Court held that a Tahsildar can refuse patta transfer because a sale deed is disputed in a civil suit? Find me the judgments.

Your AI searches the land judgments, leads with any Supreme Court ruling, and cites each case by title and date.

Responses

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

status	What it means
`ok`	At least one judgment matched.
`not_found`	No judgment in the set matched, or no query was sent.
`free_limit_reached`	Your account has used its free calls for the hour or the day. retry_after says when they come back.
`error`	The search could not be run. Nothing is charged.

Where the data comes from

Register

The published judgments of the Supreme Court of India and the Madras High Court, read in full text and searched by meaning as well as by words.

Coverage

2,922 Supreme Court land judgments selected from 43,541 reports as applying in Tamil Nadu (central Acts, general property law and Tamil Nadu statutes), 1950 to 2026. 174,060 Madras High Court land judgments from both benches, Chennai and Madurai, 2001 to 2026 and thinly before 2011: about a tenth of the court's judgments, chosen because a land authority is a party (a Tahsildar, a Sub Registrar, a Collector, CMDA, the Housing Board, HR and CE, Waqf) or the cause title names land. A private land dispute whose title says nothing about land may be missing. No other High Court, district court or tribunal.

How current

New Madras High Court judgments are pulled about once a month from a public mirror of the court's judgments; the Supreme Court set is reviewed about every three months. The set records what a judgment said, not whether it was later overruled, affirmed or distinguished.

How we read it

Each court is searched separately, by words and by meaning, and the results merged by relevance. Only the best passage of each judgment is kept, so one case never fills the list and looks like a line of authority.

Who uses it

Advocates

Find how the High Court has applied a revenue rule to facts like your client's, with the passage and the page to cite.

Bank legal teams

Check whether a title defect in an opinion has been decided before, and how.

AI assistants

Answer "has the court decided" from the judgment text, citing the case, never from memory.

Limits and good practice

Whether a judgment is still good law is not recorded. Confirm with a lawyer before relying on one.
A judgment decides its own facts. One single-judge order is not settled law.
High Court coverage is thin before 2011 and starts in 2001. Older reported cases may be missing.
This is case law, not legislation. For what a rule or act says, use knowledge_search.
Queries are read in English.

Pricing

Free

Case law search costs nothing. Free calls are subject to the account's hourly and daily allowance. 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

Questions

Is there an API for Madras High Court judgments on land?

Yes. LandLens searches land judgments of the Madras High Court and the Supreme Court and returns the matching passages with the case, court, date and a PDF link, over plain HTTPS or as an MCP tool. It is free.

Does it include Supreme Court judgments?

Yes, those that apply in Tamil Nadu: central Acts, general principles of property law and Tamil Nadu statutes. Each result names its court, and a Supreme Court result says it binds every court in India.

Does it tell me if a judgment was overruled?

No. It records what each judgment said, not its later history on appeal. Confirm with a lawyer before relying on one.

Can I limit it to recent judgments?

Yes. Send from_year, e.g. 2020, to search judgments from that year on.

What does it cost?

It costs nothing, within the account's allowance of free calls.