Build Scope API, what can be built on a plot

Example

curl -X POST https://verified.realestate/api/v1/tools/build_scope \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":12.8549,"lng":80.207,"side_a":15,"side_b":30}'

{
  "ok": true,
  "status": "not_found",
  "data": {
    "found": false,
    "gathering": true,
    "need": [
      "SIDE C length in metres (1-500)",
      "SIDE D length in metres (1-500)",
      "which side(s) face a road (A/B/C/D)",
      "the intended development type (residential / mixed_residential / commercial / institutional / industrial)"
    ],
    "note": "Ask the user for the missing inputs above conversationally (this gathering is free), then call build_scope again with everything. Tip: side A is the front; road width is the existing road, not a proposed widening."
  },
  "credits_quoted": 0,
  "credits_charged": 0,
  "credits_waived": 0
}

A real answer to an incomplete call. A complete call starts the paid report, so it is not shown here.

What it returns

A call with inputs missing answers not_found with the list of what is still needed, and charges nothing. A complete call answers queued; poll job_status with the job_id until it is done.

Inputs

The JSON body of the POST is the arguments. lat and lng are required by the schema; the four sides, the road sides with their widths and the development type are needed too.

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/build_scope \
  -H "Authorization: Bearer $LANDLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":12.8549,"lng":80.207,"side_a":15,"side_b":30}'

import os, requests

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

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

What can I build on my plot at Thazhambur? It is 15 m along the road and 30 m deep, the front faces a 9 m road, and I want a small apartment block.

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

• A planning estimate, not an approval. The planning authority decides on the drawings submitted.
• The four sides describe a four-sided plot. An irregular plot is approximated by them.
• Road width is the existing road. A road widening line is checked as an overlay, not assumed.
• Runs about 10 minutes in the background. Do not repeat the call; a second call for the same plot while one is running is not queued again.

Pricing

Questions

Related APIs