Village List

Endpoint Overview

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

Description

This API endpoint retrieves a comprehensive list of villages within a specified tehsil of a district in Madhya Pradesh. It's designed to support land verification processes by providing accurate and up-to-date village data based on administrative boundaries. The endpoint accepts district and tehsil names as inputs and returns all villages that fall within that tehsil's jurisdiction.

Key Benefits

Provides complete and accurate village data for Madhya Pradesh land verification

Simplifies the land verification process by enabling precise location selection

Supports hierarchical navigation from district to tehsil to village

Enables developers to build dynamic location selection interfaces

Use Cases

Real Estate

Financial Services

Government Services

Verify property locations during land purchase transactions

Build location selection dropdowns for property listing platforms

Validate property addresses against official administrative records

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	Bearer token authentication using JWT format
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 (case-insensitive)
tehsil	String	Yes	Name of the tehsil within the specified district (case-insensitive)

Example Request

{
    "district": "sehore",
    "tehsil": "doraha"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.district	String	Name of the district that was queried
data.tehsil	String	Name of the tehsil that was queried
data.village_list	Array of Strings	List of all villages within the specified tehsil
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": {
        "district": "sehore",
        "tehsil": "doraha",
        "village_list": [
            "ajmatnagar",
            "atraliya",
            "badarkasani",
            "badbeli",
            "bankheda",
            "baradi kalan",
            "baradi khurd",
            "barkheda deva",
            "barkheda kharet",
            "barkhedi",
            "bhoj",
            "bichhiya",
            "bichhni",
            "budha kheda",
            "chauki",
            "chhapri",
            "daulatpura",
            "dehri",
            "dhan khedi",
            "doraha",
            "dupadiya dangi",
            "gyaraspura",
            "hasanpur tinoniya",
            "hathiya kheda",
            "hinoti",
            "imaliya bhoj",
            "imaliya hasan",
            "jahangirgarh",
            "jamniya khurd",
            "jetli",
            "jhagariya",
            "jharkheda",
            "karlat",
            "kasar khedi",
            "katpon",
            "khaikheda",
            "khairabad",
            "khushamada",
            "mahuakheda",
            "majheda",
            "mandkheda",
            "manpura",
            "nabipur",
            "naihedi",
            "natrakhedi",
            "patan",
            "peerpatan",
            "pipal kheda",
            "rasulpura",
            "sankheda",
            "satoraniya",
            "satpon",
            "shahjahanpur",
            "sikandarganj",
            "sikandarpur",
            "sonkatchh",
            "takiya",
            "toraniya",
            "waheedganj"
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid District/Tehsil

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "District or tehsil not found",
    "message_code": "invalid_input"
}

This error occurs when the provided district or tehsil name doesn't exist or is misspelled.

Integration Best Practices

Security Recommendations

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

Implement token refresh mechanisms to handle token expiration gracefully

Use HTTPS for all API communications to ensure data security

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement cascading dropdowns for district → tehsil → village selection

Cache village lists for frequently accessed tehsils to improve performance

Implement fuzzy search to help users find villages despite spelling variations

Display loading indicators during API calls to provide feedback to users

Code Samples

cURL

Python

Node.js

Related APIs

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

Tehsil List API - Retrieves all tehsils within a specified district in Madhya Pradesh

Land Record Verification API - Verifies land ownership details using village, survey number, and owner information

Compliance and Legal Considerations

The village data provided by this API is sourced from official government records of Madhya Pradesh. When using this data for land verification purposes, ensure compliance with local land regulations and privacy laws. This API should be used as a reference tool and not as the sole determinant for legal land ownership decisions.

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

{ "data": { "district": "sehore", "tehsil": "doraha", "village_list": [ "ajmatnagar", "atraliya", "badarkasani", "badbeli", "bankheda", "baradi kalan", "baradi khurd", "barkheda deva", "barkheda kharet", "barkhedi", "bhoj", "bichhiya", "bichhni", "budha kheda", "chauki", "chhapri", "daulatpura", "dehri", "dhan khedi", "doraha", "dupadiya dangi", "gyaraspura", "hasanpur tinoniya", "hathiya kheda", "hinoti", "imaliya bhoj", "imaliya hasan", "jahangirgarh", "jamniya khurd", "jetli", "jhagariya", "jharkheda", "karlat", "kasar khedi", "katpon", "khaikheda", "khairabad", "khushamada", "mahuakheda", "majheda", "mandkheda", "manpura", "nabipur", "naihedi", "natrakhedi", "patan", "peerpatan", "pipal kheda", "rasulpura", "sankheda", "satoraniya", "satpon", "shahjahanpur", "sikandarganj", "sikandarpur", "sonkatchh", "takiya", "toraniya", "waheedganj" ] }, "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 ********************

Village List

Village 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

Village 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