---
title: "Order a legal opinion"
method: POST
path: "/api/v1/tools/legal_opinion_order"
---

# Order a legal opinion

`POST /api/v1/tools/legal_opinion_order`

## Request

- Base URL: `https://verified.realestate`
- URL: `https://verified.realestate/api/v1/tools/legal_opinion_order`
- Auth: HTTP bearer

Order a COMPLETE legal opinion report from just a location, one click. The full-period encumbrance certificate (typically from 1975) names every registered document; certified copies of the ones the user keeps selected are fetched from the registration department automatically, all 33+ land checks run, and the AI legal opinion generates unattended. Use when the user asks for a legal opinion, title opinion, or complete due diligence for a parcel WITHOUT documents in hand. Resolve the parcel first (the parcel lookup is free) so the revenue district/taluk/village codes and survey number are known. The user approves an exact itemized quote before anything beyond the EC read is charged. The report takes 1 hour to 30 hours; the user gets a WhatsApp message when it is ready. Returns a proposal, nothing is charged yet; it runs only once the user approves it, and the approved run costs 1 credit.

## Request body

- object
  - `lat` number, required: Latitude of the parcel
  - `lng` number, required: Longitude of the parcel
  - `survey_number` string: Survey number, e.g. "62" (required; resolve first)
  - `sub_division` string: Sub division, e.g. "2A"
  - `district_code` string: Revenue district code (from the parcel lookup)
  - `district_name` string
  - `taluk_code` string: Revenue taluk code
  - `taluk_name` string
  - `village_code` string: Revenue village code
  - `village_name` string
  - `rural_urban` 'rural' | 'urban'
  - `revenue_town_code` string: Urban parcels: revenue town code
  - `firka_ward_number` string: Urban parcels: ward
  - `urban_block_number` string: Urban parcels: block

## Response `200`

The envelope: ok, status, data, credits_charged, balance_after, request_id

## Other responses

- `401`: No valid credential
- `402`: Not enough credits
- `429`: Rate limit

---

[API](https://skmtc.dev/verified/apis/landlens-tool-api.md) · [All operations](https://skmtc.dev/verified/apis/landlens-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verified/apis/landlens-tool-api/revisions/7923c1c24431?raw)
