Source: https://legiscore.in/docs/states/karnataka/land-conversion-mutation

# Land conversion order, any year (Bhoomi mutation register) (Karnataka)

Finds the Deputy Commissioner’s conversion order of any year from the Bhoomi mutation register, including conversions older than the online conversion portal (about 2019-20).

Status: LIVE. Source status: No recent runs. Typical time: up to 5 min. state: `karnataka`, search_type: `land_conversion_mutation`.



## What you get

Each conversion mutation on the survey: DC order number and date, purpose and every converted parcel, plus the mutation register extract PDF. It is not the certified order itself, but it proves the order exists, with its number and date. Up to 10 unless you ask for more.

## 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 |
| --- | --- | --- | --- | --- |
| `district` | string | required | from lookup "district" | bhoomi_district lookup (https://legiscore.in/docs/api/lookups#karnataka-bhoomi_district) |
| `taluk` | string | required | from lookup "taluk" | bhoomi_taluk lookup (https://legiscore.in/docs/api/lookups#karnataka-bhoomi_taluk) |
| `hobli` | string | required | from lookup "hobli" | bhoomi_hobli lookup (https://legiscore.in/docs/api/lookups#karnataka-bhoomi_hobli) |
| `village` | string | required | from lookup "village" | bhoomi_village lookup (https://legiscore.in/docs/api/lookups#karnataka-bhoomi_village) |
| `survey_no` | string | required | 20 | field "survey_no" |
| `max_orders` | number | optional | 10 | field "max_orders" |

## Field details

| Field | Type | Notes |
| --- | --- | --- |
| `district` (District) | lookup |  |
| `taluk` (Taluk) | lookup |  |
| `hobli` (Hobli) | lookup | Split hoblis are listed separately, e.g. Kengeri - 1 to Kengeri - 4. |
| `village` (Village) | lookup |  |
| `survey_no` (Survey Number) | text | The survey number, or survey/hissa such as 20/2 or 20/*/2 to keep one parcel. |
| `max_orders` (Max Orders) | text | Optional. How many conversion mutations to read in full, 1-20. Max 2 characters. |

## Resolve names to codes

| Field | Lookup | Needs first |
| --- | --- | --- |
| district | bhoomi_district | - |
| taluk | bhoomi_taluk | district |
| hobli | bhoomi_hobli | district, taluk |
| village | bhoomi_village | district, taluk, hobli |

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": "karnataka",
  "search_type": "land_conversion_mutation",
  "params": {
    "district": "<district.value>",
    "taluk": "<taluk.value>",
    "hobli": "<hobli.value>",
    "village": "<village.value>",
    "survey_no": "20",
    "max_orders": 10
  },
  "label": "Land conversion order, any year (Bhoomi mutation register) - 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": "karnataka",
      "search_type": "land_conversion_mutation",
      "params": {
        "district": "<district.value>",
        "taluk": "<taluk.value>",
        "hobli": "<hobli.value>",
        "village": "<village.value>",
        "survey_no": "20",
        "max_orders": 10
      },
      "label": "Land conversion order, any year (Bhoomi mutation register) - 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": "karnataka",
    "search_type": "land_conversion_mutation",
    "params": {
      "district": "<district.value>",
      "taluk": "<taluk.value>",
      "hobli": "<hobli.value>",
      "village": "<village.value>",
      "survey_no": "20",
      "max_orders": 10
    },
    "label": "Land conversion order, any year (Bhoomi mutation register) - 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": "karnataka",
        "search_type": "land_conversion_mutation",
        "label": "Land conversion order, any year (Bhoomi mutation register) - 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": "karnataka",
    "search_type": "land_conversion_mutation",
    "label": "Land conversion order, any year (Bhoomi mutation register) - 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"
  }
}
```