---
title: "Water body"
method: POST
path: "/api/v1/tools/water_body"
---

# Water body

`POST /api/v1/tools/water_body`

## Request

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

The mapped WATER BODY POLYGONS (tank, eri, oorani, kulam, pond, lake, reservoir) from the government water bodies register, with their extent, type, owning department and record id. Three ways to call it: (1) lat + lng (from the parcel lookup) with an optional radius_m for every water body around a point, nearest first, with the distance to each polygon boundary. (2) water_body_id to open one record in full, including whether a boundary polygon exists and how large its footprint is. (3) district for how many water bodies that district has and the largest ones by extent. Use for "is there a lake near this plot", "how big is the tank next to my land", "which department owns that eri", "water bodies in this district", "how close is the nearest waterbody boundary", "what is the extent of that kulam". NAMED canals, rivers, streams and odai with distances are the separate waterways list, and the regulatory verdict on whether the plot itself sits in or beside a water body is the zone check. 1 credit. Costs 1 credit per call, waived when nothing is found.

## Request body

- object
  - `lat` number: Latitude in decimal degrees. Pair with lng.
  - `lng` number: Longitude in decimal degrees. Pair with lat.
  - `radius_m` number: Search radius in metres around lat/lng. Default 1000, minimum 100, maximum 5000.
  - `water_body_id` integer: The id of one water body, as returned in the nearby list. Opens that record with its boundary summary.
  - `district` string: District name for the register count and the largest water bodies in it, for example "Tiruvannamalai" or "Chennai".

## 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)