---
title: "X-ray of a village"
method: POST
path: "/api/v1/tools/village_xray"
---

# X-ray of a village

`POST /api/v1/tools/village_xray`

## Request

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

X-ray of an ENTIRE VILLAGE's cadastral map: how many surveys and subdivisions it has, the government vs private split (poramboke share), and the land-type mix (Wet / Dry / Natham / Poramboke). Pass the revenue codes from the parcel lookup or the place-name lookup. Use for "how big is this village", "how much of this village is government land", "wet vs dry split of the village", "village profile". 1 credit. Costs 1 credit per call, waived when nothing is found.

## Request body

- object
  - `district_code` string, required
  - `taluk_code` string, required
  - `village_code` string, required
  - `village_name` string: For the card title

## 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/54f851c86cc1?raw)