Source: https://legiscore.in/docs/states/kerala/bhunaksha

# Digital Survey Parcel Map (Ente Bhoomi) (Kerala)

A parcel on the Survey Department's digital survey map, by its digital block and survey number.

Status: LIVE. Source status: No recent runs. Typical time: up to 3 min. state: `kerala`, search_type: `bhunaksha`.



## What you get

Area in hectares, Are and square metres, land type and use, the ULPIN, the parcel outline, and the old block, survey and thandaper numbers it replaced, with the department's page. Only villages with a published digital map can be searched.

## Request parameters

Keys of `params`. A value "from lookup" is a code you get by searching for the item by name first (https://legiscore.in/docs/api/lookups).



| Name | Type | Required | Example | Comes from |
| --- | --- | --- | --- | --- |
| `village_code` | string | required | from lookup "village" | kerala_relis_village lookup (https://legiscore.in/docs/api/lookups#kerala-kerala_relis_village) |
| `digital_block_no` | string | required | 1 | field "digital_block_no" |
| `digital_survey_no` | string | required | 25 | field "digital_survey_no" |

## Field details

| Field | Type | Notes |
| --- | --- | --- |
| `district` (District) | lookup |  |
| `taluk` (Taluk) | lookup |  |
| `village` (Village) | lookup | Only villages with a published digital survey map can be searched. |
| `digital_block_no` (Digital Block Number) | text | From the digital survey (Ente Bhoomi), not the resurvey block on an older deed. Max 4 characters. |
| `digital_survey_no` (Digital Survey Number) | text | From the digital survey, not the resurvey number. The result lists the old numbers it replaced. Max 10 characters. |

## Resolve names to codes

| Field | Lookup | Needs first |
| --- | --- | --- |
| district | kerala_relis_district | - |
| taluk | kerala_relis_taluk | district |
| village | kerala_relis_village | district, taluk |

q is required (2+ characters), at most 10 matches.

## Example request

Replace each <...> with the value from its lookup match.

**curl**

```bash
curl -X POST "https://legiscore.in/api/v1/search" \
  -H "Authorization: Bearer lsk_your_api_key" \
  -H "Idempotency-Key: los-case-8841" \
  -H "Content-Type: application/json" \
  -d '{
  "state": "kerala",
  "search_type": "bhunaksha",
  "params": {
    "village_code": "<village.value>",
    "digital_block_no": "1",
    "digital_survey_no": "25"
  },
  "label": "Digital Survey Parcel Map (Ente Bhoomi) - case 8841"
}'
```

**Python**

```python
import requests

resp = requests.post(
    "https://legiscore.in/api/v1/search",
    headers={"Authorization": "Bearer lsk_your_api_key", "Idempotency-Key": "los-case-8841"},
    json={
      "state": "kerala",
      "search_type": "bhunaksha",
      "params": {
        "village_code": "<village.value>",
        "digital_block_no": "1",
        "digital_survey_no": "25"
      },
      "label": "Digital Survey Parcel Map (Ente Bhoomi) - case 8841"
    },
)
resp.raise_for_status()
print(resp.json())
```

**Node**

```js
const resp = await fetch("https://legiscore.in/api/v1/search", {
  method: "POST",
  headers: { Authorization: "Bearer lsk_your_api_key", "Idempotency-Key": "los-case-8841", "Content-Type": "application/json" },
  body: JSON.stringify({
    "state": "kerala",
    "search_type": "bhunaksha",
    "params": {
      "village_code": "<village.value>",
      "digital_block_no": "1",
      "digital_survey_no": "25"
    },
    "label": "Digital Survey Parcel Map (Ente Bhoomi) - case 8841"
  }),
});
if (!resp.ok) throw new Error(await resp.text());
console.log(await resp.json());
```

## Sample responses

202 Accepted, at submit:

```json
{
  "data": {
    "searches": [
      {
        "id": "SRCH-2026-A1B2C3D4",
        "state": "kerala",
        "search_type": "bhunaksha",
        "label": "Digital Survey Parcel Map (Ente Bhoomi) - case 8841",
        "status": "queued",
        "progress": 0,
        "note": null,
        "found": null,
        "records": null,
        "record_count": null,
        "documents": [],
        "error": null,
        "refunded": false,
        "replayed": false,
        "batch_id": null,
        "recovery_of": null,
        "source": "api",
        "created_at": "2026-10-05T10:00:00Z",
        "completed_at": null
      }
    ],
    "rejected": [],
    "replayed": {
      "free": 0,
      "billed": 0,
      "idempotent": 0
    },
    "batch_id": null
  }
}
```

200 OK, GET /api/v1/search/{id} once finished:

```json
{
  "data": {
    "id": "SRCH-2026-A1B2C3D4",
    "state": "kerala",
    "search_type": "bhunaksha",
    "label": "Digital Survey Parcel Map (Ente Bhoomi) - case 8841",
    "status": "succeeded",
    "progress": 100,
    "note": null,
    "found": true,
    "records": [
      {
        "...": "one object per row the source returned; shape varies by search"
      }
    ],
    "record_count": 1,
    "documents": [
      {
        "filename": "result.pdf",
        "content_type": "application/pdf",
        "bytes": 184233,
        "withheld": false
      }
    ],
    "error": null,
    "refunded": false,
    "replayed": false,
    "batch_id": null,
    "recovery_of": null,
    "source": "api",
    "created_at": "2026-10-05T10:00:00Z",
    "completed_at": "2026-10-05T10:03:12Z"
  }
}
```