Karnataka Land Verification

Endpoint Overview

POST /api/v1/land-verification/karnataka

Description

This API endpoint retrieves comprehensive land ownership and valuation details from Karnataka's land records database. It provides authenticated access to official land records based on specific location parameters and khata number. The API returns detailed information about land parcels including ownership details, area measurements, and various valuation metrics that are essential for property verification, loan processing, and legal documentation.

Key Benefits

Instant access to official Karnataka land records without manual verification

Comprehensive land valuation metrics including shape value, local call area, healthcare and education contributions

Structured data format with both individual land parcel details and consolidated summary

Reliable verification of land ownership for legal and financial processes

Use Cases

Banking & Finance

Real Estate

Legal Services

Verify land ownership and valuation during mortgage or agricultural loan processing

Assess property collateral value for secured loans

Validate land assets during wealth management advisory

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 where the land is located
taluka	String	Yes	Name of the taluka (administrative division)
hobli	String	Yes	Name of the hobli (cluster of villages)
village	String	Yes	Name of the village where the land is located
khata_no	String	Yes	Khata number for the land record

Example Request

{
    "district": "belgaum",
    "taluka": "chikkodi",
    "hobli": "chikkodi",
    "village": "chikkodi",
    "khata_no": "1"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for all response data
data.client_id	String	Unique identifier for the verification request
data.district	String	Name of the district as provided in the request
data.taluka	String	Name of the taluka as provided in the request
data.hobli	String	Name of the hobli as provided in the request
data.village	String	Name of the village as provided in the request
data.khata_no	String	Khata number as provided in the request
data.land_details	Array	List of land parcels and their details
data.total_summary	Object	Aggregated summary of all land values
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

Land Details Object

Parameter	Type	Description
order_number	String	Sequential order number of the land record
hissa_number	String	Unique subdivision identifier for the land parcel
owner_name	String	Name of the registered landowner
area	String	Total land area in the format of acres.guntas.sq.ft
shape	String	Shape value assessment of the land
local_call	String	Local call area assessment value
health_care	String	Healthcare contribution assessment value
vidya_kara	String	Education (Vidya Kara) contribution assessment value
total	String	Sum of all assessment values for this land parcel

Total Summary Object

Parameter	Type	Description
total_area	String	Combined area of all land parcels
total_shape	String	Combined shape value of all land parcels
total_local_call	String	Combined local call area value of all land parcels
total_health_care	String	Combined healthcare contribution value of all land parcels
total_vidya_kara	String	Combined education contribution value of all land parcels
grand_total	String	Sum of all assessment values across all land parcels

Example Successful Response

{
    "data": {
        "client_id": "karnataka_land_verification_nHcQyIyyWhtOwPfbSwbI",
        "district": "belgaum",
        "taluka": "chikkodi",
        "hobli": "chikkodi",
        "village": "chikkodi",
        "khata_no": "1",
        "land_details": [
            {
                "order_number": "1",
                "hissa_number": "33/*/2 ಎ",
                "owner_name": "ಅಲಾಸೆ ಪ್ರಕಾಶ ಶಾಂತಿನಾಥ",
                "area": "0.15.00.00",
                "shape": "0.23",
                "local_call": "0.12",
                "health_care": "0.03",
                "vidya_kara": "0.02",
                "total": "0.4"
            }
        ],
        "total_summary": {
            "total_area": "0.15.00.00",
            "total_shape": "0.23",
            "total_local_call": "0.12",
            "total_health_care": "0.03",
            "total_vidya_kara": "0.02",
            "grand_total": "0.4"
        }
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Parameters

Record Not Found

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid parameters provided",
    "message_code": "invalid_parameters"
}

This error occurs when one or more required parameters are missing or invalid.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption

Implement token refresh mechanisms to handle JWT expiration gracefully

User Experience Guidelines

Implement input validation before making API calls to reduce errors

Display loading indicators during API calls as land verification may take a few seconds

Format the returned land area values appropriately for better readability

Provide clear error messages to users when verification fails

Code Samples

cURL

Python

Node.js

Related APIs

Karnataka RTC Verification - Retrieves Record of Rights, Tenancy and Crops (RTC) information

Property Ownership Verification - Verifies property ownership across multiple states

Land Encumbrance Certificate - Retrieves encumbrance certificates for land parcels

Compliance and Legal Considerations

The land records data provided by this API is sourced from official Karnataka government records. While the data is retrieved from authoritative sources, it should be used for verification purposes only and not as the sole basis for legal decisions. For legal proceedings, original certified copies of land documents may be required. Users must comply with all applicable data privacy regulations when storing and processing this information.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/land-verification/karnataka' \ --header 'Content-Type: application/json' \ --data-raw '{ "district": "belgaum", "taluka": "chikkodi", "hobli": "chikkodi", "village": "chikkodi", "khata_no": "1" }'

{ "data": { "client_id": "karnataka_land_verification_nHcQyIyyWhtOwPfbSwbI", "district": "belgaum", "taluka": "chikkodi", "hobli": "chikkodi", "village": "chikkodi", "khata_no": "1", "land_details": [ { "order_number": "1", "hissa_number": "33/*/2 ಎ", "owner_name": "ಅಲಾಸೆ ಪ್ರಕಾಶ ಶಾಂತಿನಾಥ", "area": "0.15.00.00", "shape": "0.23", "local_call": "0.12", "health_care": "0.03", "vidya_kara": "0.02", "total": "0.4" } ], "total_summary": { "total_area": "0.15.00.00", "total_shape": "0.23", "total_local_call": "0.12", "total_health_care": "0.03", "total_vidya_kara": "0.02", "grand_total": "0.4" } }, "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 ********************

Karnataka Land Verification

Karnataka Land Verification#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Land Details Object#

Total Summary Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Karnataka Land Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Land Details Object

Total Summary Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples