Block List

Endpoint Overview

GET /api/v1/land-verification/block-list

Description

This API endpoint retrieves a hierarchical list of administrative divisions (talukas, hoblis, and villages) associated with a specified district. It provides a comprehensive geographical breakdown that can be used for land verification processes, address validation, or location-based services.

Key Benefits

Obtain complete hierarchical data of administrative divisions in a single API call

Access standardized location identifiers for each geographical entity

Simplify location selection in user interfaces with ready-to-use dropdown options

Enable accurate land record verification with precise location mapping

Use Cases

Real Estate

Government Services

Financial Services

Verify property locations during land purchase transactions

Validate addresses for property listings and documentation

Create location-based property search filters

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 for authentication (JWT format)
Content-Type	Yes	Application/json

Request Body

Parameter	Type	Required	Description
district	String	Yes	Name of the district for which to retrieve administrative divisions

Example Request

{
    "district": "belgaum"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the hierarchical administrative division data
data.district_name	String	Name of the requested district
data.taluka_list	Array	List of talukas within the district
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

Taluka Object Structure

Parameter	Type	Description
taluka	String	Name of the taluka
value	String	Unique identifier for the taluka
hobli_list	Array	List of hoblis within the taluka

Hobli Object Structure

Parameter	Type	Description
hobli	String	Name of the hobli
value	String	Unique identifier for the hobli
village_list	Array	List of villages within the hobli

Village Object Structure

Parameter	Type	Description
village	String	Name of the village
value	String	Unique identifier for the village

Example Successful Response

{
    "data": {
        "district_name": "belgaum",
        "taluka_list": [
            {
                "taluka": "chikkodi",
                "value": "1",
                "hobli_list": [
                    {
                        "hobli": "chikkodi",
                        "value": "1",
                        "village_list": [
                            {
                                "village": "chikkodi",
                                "value": "1"
                            },
                            {
                                "village": "ingali",
                                "value": "2"
                            }
                            // Additional villages omitted for brevity
                        ]
                    }
                    // Additional hoblis omitted for brevity
                ]
            }
            // Additional talukas omitted for brevity
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid District

Authentication Error

{
    "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 or is misspelled.

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

Validate and sanitize the district parameter to prevent injection attacks

User Experience Guidelines

Implement cascading dropdowns for location selection (district → taluka → hobli → village)

Cache responses to improve performance for frequently accessed districts

Provide autocomplete functionality for district names to prevent errors

Display friendly error messages to users when location data cannot be retrieved

Code Samples

cURL

Python

Node.js

Related APIs

Land Record Verification API: Verifies land ownership details using the location information

Property Tax Assessment API: Retrieves property tax information for a specific location

Land Use Classification API: Provides zoning and land use information for specified locations

Compliance and Legal Considerations

The geographical data provided by this API is for informational purposes and should be used in accordance with local regulations. When using this data for official documentation or legal proceedings, it's recommended to verify the information with the appropriate government authorities. Data usage should comply with relevant data protection and privacy laws.

{ "data": { "district_name": "belgaum", "taluka_list": [ { "taluka": "chikkodi", "value": "1", "hobli_list": [ { "hobli": "chikkodi", "value": "1", "village_list": [ { "village": "chikkodi", "value": "1" }, { "village": "ingali", "value": "2" }, { "village": "jodakurali", "value": "3" }, { "village": "kutali", "value": "4" }, { "village": "sankanavadi", "value": "5" } ] }, { "hobli": "sadalaga", "value": "2", "village_list": [ { "village": "sadalaga", "value": "1" }, { "village": "nagarala", "value": "2" }, { "village": "manakapura", "value": "3" }, { "village": "janavada", "value": "4" }, { "village": "shamanevadi", "value": "5" }, { "village": "nanadi", "value": "6" }, { "village": "bedakihala", "value": "8" }, { "village": "neja", "value": "9" }, { "village": "galataga", "value": "10" } ] } ] }, { "taluka": "athani", "value": "2", "hobli_list": [ { "hobli": "kagavada", "value": "1", "village_list": [ { "village": "krushnakittura", "value": "1" }, { "village": "ainapura", "value": "2" }, { "village": "ugara khurda", "value": "3" }, { "village": "ugara budruk", "value": "4" }, { "village": "kowlagudda", "value": "5" }, { "village": "kempavada", "value": "6" }, { "village": "navalihala", "value": "7" }, { "village": "katrala", "value": "8" }, { "village": "banajavada", "value": "9" }, { "village": "kagavada", "value": "10" } ] }, { "hobli": "anantapura", "value": "2", "village_list": [ { "village": "anantapura", "value": "1" }, { "village": "malabada", "value": "2" }, { "village": "balligeri", "value": "3" }, { "village": "pandeganva", "value": "4" }, { "village": "khileganva", "value": "5" } ] } ] }, { "taluka": "raibag", "value": "3", "hobli_list": [ { "hobli": "rayabaga", "value": "1", "village_list": [ { "village": "rayabaga", "value": "1" }, { "village": "mekhali", "value": "2" }, { "village": "mavinahonda", "value": "3" }, { "village": "nandikurali", "value": "4" }, { "village": "nasalapura", "value": "5" }, { "village": "hubbaravadi", "value": "6" }, { "village": "bavachi", "value": "7" }, { "village": "maradi", "value": "8" }, { "village": "yadranva", "value": "10" }, { "village": "budihala", "value": "11" } ] }, { "hobli": "kudachi", "value": "2", "village_list": [ { "village": "kudachi", "value": "1" }, { "village": "katakabanvi", "value": "2" }, { "village": "koligudda", "value": "3" }, { "village": "yabaratti", "value": "4" }, { "village": "bastavada", "value": "5" }, { "village": "khanadala", "value": "6" }, { "village": "bekkeri", "value": "7" }, { "village": "alagavadi", "value": "8" }, { "village": "itanala", "value": "9" } ] } ] } ] }, "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 ********************

Block List

Block List#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Taluka Object Structure#

Hobli Object Structure#

Village Object Structure#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Block List

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Taluka Object Structure

Hobli Object Structure

Village Object Structure

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples