States / Tamil Nadu / Guideline Value (Stamp Duty)

Tamil Nadu search

Guideline Value (Stamp Duty) HELD

The government guideline value for a Tamil Nadu village, and for one survey number in it when you give it. Without a survey number you get the village’s land-category rate table.

Typical time: up to 3 min
Source status: Held
search_type: guideline_value

Held: not accepting searches right now

This search is temporarily unavailable. A submit is refused with 422 search_unavailable and nothing is charged. This page updates when the hold is lifted.

This search reads a register published for an area, not a per-property answer. found: false means no per-property match was computed. The documents are the deliverable, so read them.

What you get

The guideline rates for the village or survey number, as the registration department publishes them.

Request parameters

These are the keys of params in the request body. A value shown as from lookup is a code you get by searching for the item by name first, not text you type.

Name	Type	Required	Example	Comes from
`zone`	string	Required	1 or Chennai	field "zone"
`sro`	string	Required	Red Hills	field "sro"
`village`	string	Required	Pothur	field "village"
`survey_no`	string	Optional	245/1	field "survey_no"

Field details

Field	Type	Notes
`zone` Zone	text	The zone number or its English name.
`sro` Sub-Registrar Office	text	The office code (20076) or its English name. A name the portal does not list is refused with the names it does.
`village` Village	text	The village code (627) or its English name.
`survey_no` Survey Number	text	Optional. Left blank, you get the village’s land-category rate table instead of one survey number.

Example request

Replace each <...> with the value from its lookup match, and the sample values with your own.

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": "tamilnadu",
  "search_type": "guideline_value",
  "params": {
    "zone": "1 or Chennai",
    "sro": "Red Hills",
    "village": "Pothur",
    "survey_no": "245/1"
  },
  "label": "Guideline Value (Stamp Duty) - case 8841"
}'

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": "tamilnadu",
      "search_type": "guideline_value",
      "params": {
        "zone": "1 or Chennai",
        "sro": "Red Hills",
        "village": "Pothur",
        "survey_no": "245/1"
      },
      "label": "Guideline Value (Stamp Duty) - case 8841"
    },
)
resp.raise_for_status()
print(resp.json())

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": "tamilnadu",
    "search_type": "guideline_value",
    "params": {
      "zone": "1 or Chennai",
      "sro": "Red Hills",
      "village": "Pothur",
      "survey_no": "245/1"
    },
    "label": "Guideline Value (Stamp Duty) - 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": "tamilnadu",
        "search_type": "guideline_value",
        "label": "Guideline Value (Stamp Duty) - 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": "tamilnadu",
    "search_type": "guideline_value",
    "label": "Guideline Value (Stamp Duty) - 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"
  }
}

records holds one object per row the source returned. Its shape is specific to this search. Documents are fetched with GET /api/v1/search/{id}/documents/{filename}.

View as Markdown llms-full.txt

States / Tamil Nadu / Guideline Value (Stamp Duty)

Tamil Nadu search

Guideline Value (Stamp Duty) HELD

The government guideline value for a Tamil Nadu village, and for one survey number in it when you give it. Without a survey number you get the village’s land-category rate table.

Typical time: up to 3 min
Source status: Held
search_type: guideline_value

Held: not accepting searches right now

This search is temporarily unavailable. A submit is refused with 422 search_unavailable and nothing is charged. This page updates when the hold is lifted.

This search reads a register published for an area, not a per-property answer. found: false means no per-property match was computed. The documents are the deliverable, so read them.

What you get

The guideline rates for the village or survey number, as the registration department publishes them.

Request parameters

These are the keys of params in the request body. A value shown as from lookup is a code you get by searching for the item by name first, not text you type.

Name	Type	Required	Example	Comes from
`zone`	string	Required	1 or Chennai	field "zone"
`sro`	string	Required	Red Hills	field "sro"
`village`	string	Required	Pothur	field "village"
`survey_no`	string	Optional	245/1	field "survey_no"

Field details

Field	Type	Notes
`zone` Zone	text	The zone number or its English name.
`sro` Sub-Registrar Office	text	The office code (20076) or its English name. A name the portal does not list is refused with the names it does.
`village` Village	text	The village code (627) or its English name.
`survey_no` Survey Number	text	Optional. Left blank, you get the village’s land-category rate table instead of one survey number.

Example request

Replace each <...> with the value from its lookup match, and the sample values with your own.

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": "tamilnadu",
  "search_type": "guideline_value",
  "params": {
    "zone": "1 or Chennai",
    "sro": "Red Hills",
    "village": "Pothur",
    "survey_no": "245/1"
  },
  "label": "Guideline Value (Stamp Duty) - case 8841"
}'

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": "tamilnadu",
      "search_type": "guideline_value",
      "params": {
        "zone": "1 or Chennai",
        "sro": "Red Hills",
        "village": "Pothur",
        "survey_no": "245/1"
      },
      "label": "Guideline Value (Stamp Duty) - case 8841"
    },
)
resp.raise_for_status()
print(resp.json())

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": "tamilnadu",
    "search_type": "guideline_value",
    "params": {
      "zone": "1 or Chennai",
      "sro": "Red Hills",
      "village": "Pothur",
      "survey_no": "245/1"
    },
    "label": "Guideline Value (Stamp Duty) - 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": "tamilnadu",
        "search_type": "guideline_value",
        "label": "Guideline Value (Stamp Duty) - 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": "tamilnadu",
    "search_type": "guideline_value",
    "label": "Guideline Value (Stamp Duty) - 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"
  }
}

records holds one object per row the source returned. Its shape is specific to this search. Documents are fetched with GET /api/v1/search/{id}/documents/{filename}.