Tehsil List

Endpoint Overview

POST /api/v1/land-verification/madhya-pradesh/meta/tehsil-list

Description

This API endpoint retrieves a comprehensive list of tehsils (administrative subdivisions) within a specified district of Madhya Pradesh. It's designed to support land verification processes by providing accurate administrative boundary information. When provided with a district name, the API returns all tehsils within that district, enabling applications to present users with valid options for further land verification queries.

Key Benefits

Simplifies land verification workflows by providing accurate administrative subdivision data

Reduces user input errors by offering validated tehsil options for a selected district

Enables dynamic form population for location-based verification processes

Supports hierarchical data navigation in land record applications

Use Cases

Real Estate

Financial Services

Government Services

Property title verification before purchase transactions

Land development project planning requiring tehsil-level approvals

Real estate listing platforms needing administrative boundary validation

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	JWT Bearer token for authentication. Format: `Bearer <your_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
district	String	Yes	Name of the district in Madhya Pradesh for which tehsil list is required. Case insensitive.

Example Request

{
    "district": "sehore"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.district	String	Name of the district that was queried
data.tehsil_list	Array of Strings	List of all tehsils within the specified district
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the request was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code representing the result

Example Successful Response

{
    "data": {
        "district": "sehore",
        "tehsil_list": [
            "ashta",
            "bhairunda",
            "budhni",
            "doraha",
            "ichhawar",
            "jawar",
            "rehti",
            "sehore",
            "sehore nagar",
            "shyampur"
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid District

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid district name provided",
    "message_code": "invalid_district"
}

This error occurs when the provided district name doesn't exist in Madhya Pradesh or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement token refresh mechanisms to handle JWT expiration gracefully

Use HTTPS for all API communications to ensure data privacy

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement district selection before tehsil selection in a cascading dropdown interface

Cache tehsil lists for frequently accessed districts to improve performance

Provide clear error messages to users when district validation fails

Consider implementing autocomplete for district names to reduce input errors

Code Samples

cURL

Python

Node.js

Related APIs

District List API - Retrieves all districts in Madhya Pradesh for land verification

Village List API - Retrieves villages within a specified tehsil for land verification

Land Record Verification API - Verifies land ownership details using district, tehsil, and village information

Compliance and Legal Considerations

This API provides administrative boundary information for Madhya Pradesh, India. The data should be used in compliance with Indian land record regulations. While the API facilitates access to public administrative information, any land verification processes built using this data should comply with the Madhya Pradesh Land Revenue Code and related regulations. This API does not provide actual land ownership records, which require separate verification through appropriate government channels.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/land-verification/madhya-pradesh/meta/tehsil-list' \ --header 'Content-Type: application/json' \ --data-raw '{ "district": "sehore" }'

{ "data": { "district": "sehore", "tehsil_list": [ "ashta", "bhairunda", "budhni", "doraha", "ichhawar", "jawar", "rehti", "sehore", "sehore nagar", "shyampur" ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Tehsil List

Tehsil List#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Tehsil List

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples