Certified Copy API for Tamil Nadu registered documents

Example

curl -X POST https://verified.realestate/api/v1/tools/certified_copy \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document_no":"2711","year":"2019","sro_name":"Neelankarai"}'

{
  "ok": true,
  "status": "proposal",
  "data": {
    "proposal": true,
    "action": "certified_copy",
    "label": "Order the certified copy of Doc 2711/2019 (Neelankarai SRO)",
    "params": { "document_no": "2711", "year": "2019", "sro_code": "20066:1", "sro_name": "Neelankarai" },
    "cost": 10,
    "source": "Certified copy (SRO)",
    "details": [
      { "k": "Document", "v": "2711/2019" },
      { "k": "Ordering from", "v": "Neelankarai sub registrar office" },
      { "k": "Parties", "v": "Not known yet. This office comes from the parcel, not from the document, so confirm it before approving." }
    ],
    "note": "The official copy usually takes 30 minutes to 30 hours to arrive. It posts into this chat and we also WhatsApp it to you the moment it is ready."
  },
  "credits_quoted": 0,
  "credits_charged": 0,
  "next": { "tool": "approve_action", "arguments": { "action": "certified_copy", "params": { "document_no": "2711", "year": "2019", "sro_code": "20066:1", "sro_name": "Neelankarai" } } }
}

A real quote from the API; already_held, balance_after and request_id are left out. It was not approved.

What it returns

The first call returns a quote, with status proposal. Send its next block to approve_action within 30 minutes; the order is placed at once and the copy follows.

Inputs

The JSON body of the POST is the arguments. document_no and year are required; the office is needed too, as a code or a name.

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/certified_copy \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document_no":"2711","year":"2019","sro_name":"Neelankarai"}'

import os, requests

r = requests.post(
    "https://verified.realestate/api/v1/tools/certified_copy",
    headers={"Authorization": f"Bearer {os.environ['LANDLENS_KEY']}"},
    json={
        "document_no": "2711",
        "year": "2019",
        "sro_name": "Neelankarai"
    },
    timeout=60,
)
body = r.json()
print(body["status"], body["credits_charged"], body["data"])

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

Order the certified copy of document 2711 of 2019 at Neelankarai sub registrar office.

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 copy takes 30 minutes to 30 hours. It is delivered to your LandLens account's certified copies and by WhatsApp to the account's number; the API answer carries the order id and a status_url, which carries the file's link once the copy is in.
• Check the office. A deed is held by the office it was registered at; when the quote says the office came from the parcel, confirm it before approving.
• Credits come back automatically only when the department confirms it holds no such document. A copy that cannot be fetched automatically for another reason is obtained by our team by hand, and is not refunded.
• One document per order.

Pricing

Questions

Related APIs