Source: https://legiscore.in/docs/states/uttarpradesh/bhulekh

# Khatauni / Record of Rights (UP Bhulekh) (Uttar Pradesh)

The Khatauni for a khasra or khata number: who holds the land today, their shares and the area, as the revenue record reads.

Status: LIVE. Source status: No recent runs. Typical time: up to 4 min. state: `uttarpradesh`, search_type: `bhulekh`.



## What you get

One record per khata: each holder with father’s or husband’s name, share and share area, plus the Khatauni as a PDF (up to 10 khatas by default).

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

- At least one of `khasra_no`, `khata_no`: Give a khasra number or a khata number.

| Name | Type | Required | Example | Comes from |
| --- | --- | --- | --- | --- |
| `district_code` | string | required | from lookup "district" | uttarpradesh_district lookup (https://legiscore.in/docs/api/lookups#uttarpradesh-uttarpradesh_district) |
| `tehsil_code` | string | required | from lookup "tehsil" | uttarpradesh_tehsil lookup (https://legiscore.in/docs/api/lookups#uttarpradesh-uttarpradesh_tehsil) |
| `village_code` | string | required | from lookup "village" | uttarpradesh_village lookup (https://legiscore.in/docs/api/lookups#uttarpradesh-uttarpradesh_village) |
| `khasra_no` | string | one of | 67/3 | field "khasra_no" |
| `khata_no` | string | one of | 243 | field "khata_no" |
| `max_records` | number | optional | 10 | field "max_records" |

## Field details

| Field | Type | Notes |
| --- | --- | --- |
| `district` (District) | lookup |  |
| `tehsil` (Tehsil) | lookup |  |
| `village` (Village) | lookup | Type in English or Hindi. The village as the Khatauni names it. |
| `khasra_no` (Khasra / Gata Number) | text | Give the khasra OR the khata, not both. Sub-plot letters in Hindi: 283ख. Max 40 characters. |
| `khata_no` (Khata Number) | text | Max 5 characters. |
| `max_records` (Max Records) | text | Optional, 1 to 30. A plot held under many khatas stops at this many Khataunis. Max 2 characters. |

## Resolve names to codes

| Field | Lookup | Needs first |
| --- | --- | --- |
| district | uttarpradesh_district | - |
| tehsil | uttarpradesh_tehsil | district |
| village | uttarpradesh_village | district, tehsil |

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": "uttarpradesh",
  "search_type": "bhulekh",
  "params": {
    "district_code": "<district.value>",
    "tehsil_code": "<tehsil.value>",
    "village_code": "<village.value>",
    "khasra_no": "67/3",
    "khata_no": "243",
    "max_records": 10
  },
  "label": "Khatauni / Record of Rights (UP Bhulekh) - 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": "uttarpradesh",
      "search_type": "bhulekh",
      "params": {
        "district_code": "<district.value>",
        "tehsil_code": "<tehsil.value>",
        "village_code": "<village.value>",
        "khasra_no": "67/3",
        "khata_no": "243",
        "max_records": 10
      },
      "label": "Khatauni / Record of Rights (UP Bhulekh) - 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": "uttarpradesh",
    "search_type": "bhulekh",
    "params": {
      "district_code": "<district.value>",
      "tehsil_code": "<tehsil.value>",
      "village_code": "<village.value>",
      "khasra_no": "67/3",
      "khata_no": "243",
      "max_records": 10
    },
    "label": "Khatauni / Record of Rights (UP Bhulekh) - 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": "uttarpradesh",
        "search_type": "bhulekh",
        "label": "Khatauni / Record of Rights (UP Bhulekh) - 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": "uttarpradesh",
    "search_type": "bhulekh",
    "label": "Khatauni / Record of Rights (UP Bhulekh) - 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"
  }
}
```
