Village List

Endpoint Overview

POST /api/v1/land-verification/gujarat/meta/village-list

Description

This API endpoint retrieves a comprehensive list of villages within a specified taluka of a district in Gujarat state. It is part of the Land Verification service and helps users identify all villages that fall under a particular administrative division. The endpoint requires both district and taluka names as inputs and returns a structured list of all villages within that jurisdiction.

Key Benefits

Provides accurate and up-to-date village data for Gujarat land verification processes

Simplifies geographic data collection for land-related applications

Enables hierarchical navigation through Gujarat's administrative divisions

Supports data validation for land records and property verification

Use Cases

Real Estate

Government Services

Financial Services

Property developers can verify village locations when planning new projects

Real estate agents can confirm property jurisdictions for listings

Land surveyors can validate village boundaries for accurate assessments

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
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
district	String	Yes	Name of the district in Gujarat (case-insensitive)
taluka	String	Yes	Name of the taluka within the specified district (case-insensitive)

Example Request

{
    "district": "sabarkantha",
    "taluka": "prantij"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.district_name	String	Name of the requested district
data.taluka_name	String	Name of the requested taluka
data.village_list	Array of Strings	List of all villages within the specified taluka
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_name": "sabarkantha",
        "taluka_name": "prantij",
        "village_list": [
            "amalani muvadi",
            "ambavada",
            "aminpur",
            "amodra",
            "amrapur",
            "asroda",
            "baini muvadi",
            "bakarpur",
            "balisana",
            "bobha",
            "chhadarda",
            "dalani muvadi",
            "dalpur",
            "fatepur",
            "gadi",
            "galesara",
            "ged",
            "ghadkan",
            "hadmatiya",
            "indrajpur",
            "jenpur",
            "kalipura",
            "kamalpur",
            "karol",
            "katpur",
            "katwad",
            "kesharpur",
            "lalpur (jenpur)",
            "limla",
            "mahadevpura (ghadi)",
            "majra",
            "mamroli",
            "mauchha",
            "mavani muvadi",
            "memadpur",
            "morvad",
            "moyad",
            "nananpur",
            "nikodiya",
            "oran",
            "padhayda",
            "pallachar",
            "piludra",
            "poglu",
            "poyada",
            "prantij",
            "punadra",
            "raslod",
            "rasulpur",
            "sadani muvadi",
            "sadoliya",
            "salal",
            "sanpad",
            "sitvada",
            "sonasan",
            "sukhad",
            "tajpur(oran)",
            "unchha",
            "vadrad",
            "vadvasa",
            "vaghpur",
            "vaghrota",
            "vajapur",
            "zalani muvadi",
            "zinzva"
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid District

Invalid Taluka

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 Gujarat.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Use HTTPS for all API communications to ensure data encryption

Implement proper error handling for authentication failures

User Experience Guidelines

Implement autocomplete for district and taluka inputs to reduce errors

Cache village lists for frequently accessed talukas to improve performance

Display village names alphabetically in user interfaces for easier navigation

Provide clear error messages to users when district or taluka inputs are invalid

Code Samples

cURL

Python

Node.js

Related APIs

District List API - Retrieves all districts in Gujarat for land verification

Taluka List API - Retrieves all talukas within a specified district in Gujarat

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

Property Details API - Retrieves detailed property information for a specific location

Compliance and Legal Considerations

The village data provided by this API is sourced from official Gujarat government records. When using this data for legal or financial purposes, it's advisable to cross-verify with the latest official records as administrative boundaries may change over time. This API is designed for informational purposes and should be used in compliance with applicable data protection and privacy laws.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/land-verification/gujarat/meta/village-list' \ --header 'Content-Type: application/json' \ --data-raw '{ "district": "sabarkantha", "taluka": "prantij" }'

{ "data": { "district_name": "sabarkantha", "taluka_name": "prantij", "village_list": [ "amalani muvadi", "ambavada", "aminpur", "amodra", "amrapur", "asroda", "baini muvadi", "bakarpur", "balisana", "bobha", "chhadarda", "dalani muvadi", "dalpur", "fatepur", "gadi", "galesara", "ged", "ghadkan", "hadmatiya", "indrajpur", "jenpur", "kalipura", "kamalpur", "karol", "katpur", "katwad", "kesharpur", "lalpur (jenpur)", "limla", "mahadevpura (ghadi)", "majra", "mamroli", "mauchha", "mavani muvadi", "memadpur", "morvad", "moyad", "nananpur", "nikodiya", "oran", "padhayda", "pallachar", "piludra", "poglu", "poyada", "prantij", "punadra", "raslod", "rasulpur", "sadani muvadi", "sadoliya", "salal", "sanpad", "sitvada", "sonasan", "sukhad", "tajpur(oran)", "unchha", "vadrad", "vadvasa", "vaghpur", "vaghrota", "vajapur", "zalani muvadi", "zinzva" ] }, "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