Gujarat Land Verification

Endpoint Overview

POST /api/v1/land-verification/gujarat

Description

The Gujarat Land Verification API provides comprehensive land record details from Gujarat state's official records. This endpoint allows you to retrieve information about land ownership, khata numbers, and assessment details by providing location parameters and owner name. The API performs name matching to identify potential land records associated with the specified owner and returns detailed information along with a name match score to help verify land ownership claims.

Key Benefits

Instant verification of land ownership claims in Gujarat

Access to official land records with owner details in both English and Gujarati

Name matching algorithm to identify potential matches even with spelling variations

Comprehensive summary of total land area and assessment amounts

Use Cases

Banking & Finance

Real Estate

Legal Services

Verify land ownership during loan application processing

Assess land assets as collateral for agricultural or property loans

Validate land ownership claims during mortgage underwriting

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 or sub-district
village	String	Yes	Name of the village where the land is located
block	String	Yes	Block number or identifier of the land
owner_name	String	Yes	Name of the landowner to verify

Example Request

{
    "district": "sabarkantha",
    "taluka": "prantij",
    "village": "kamalpur",
    "block": "14",
    "owner_name": "SHANUBHAI"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for all response data
data.client_id	String	Unique identifier for the API 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.village	String	Name of the village as provided in the request
data.block_code	String	Block code as provided in the request
data.input_owner_name	String	Name of the owner as provided in the request
data.land_details	Array of Objects	List of land records that potentially match the owner name
data.land_details[].khata_number	String	Number assigned to the land parcel in official records
data.land_details[].owner_name	String	Name of the owner in English as per records
data.land_details[].owner_name_gujarati	String	Name of the owner in Gujarati as per records
data.land_details[].name_match_score	Integer	Score indicating how closely the record matches the input name (0-100)
data.total_summary	Object	Summary of land details
data.total_summary.total_area	String	Total area of the land in the format "acre-guntha-square meter"
data.total_summary.assessment_amount	String	Assessment amount for the land in rupees
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the API call was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code describing the result

Example Successful Response

{
    "data": {
        "client_id": "gujarat_land_verification_nxhrtWyiyXtazErKXAvU",
        "district": "sabarkantha",
        "taluka": "prantij",
        "village": "kamalpur",
        "block_code": "14",
        "input_owner_name": "shanubhai",
        "land_details": [
            {
                "khata_number": "111",
                "owner_name": "Patel Jagdishbhai Keshbhai",
                "owner_name_gujarati": "પટેલ જગદીશભાઈ કેશાભાઈ",
                "name_match_score": 42
            },
            {
                "khata_number": "111",
                "owner_name": "Patel Keeratbhai Keshbhai",
                "owner_name_gujarati": "પટેલ કીરીટભાઈ કેશાભાઈ",
                "name_match_score": 44
            },
            {
                "khata_number": "111",
                "owner_name": "Patel Sureshbhai Keshbhai",
                "owner_name_gujarati": "પટેલ સુરેશભાઈ કેશાભાઈ",
                "name_match_score": 50
            },
            {
                "khata_number": "111",
                "owner_name": "Patel Bharatiben Keshbhai",
                "owner_name_gujarati": "પટેલ ભારતીબેન કેશાભાઈ",
                "name_match_score": 44
            }
        ],
        "total_summary": {
            "total_area": "1-32-28",
            "assessment_amount": "5.40"
        }
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Parameters

Authentication Error

Record Not Found

{
    "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 keys 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 IP whitelisting for production environments when possible

User Experience Guidelines

Implement progressive loading indicators for API requests that may take time

Display name match scores prominently to help users assess the reliability of matches

Provide both English and Gujarati names in user interfaces when available

Consider implementing a minimum match score threshold for automatic verification

Code Samples

cURL

Python

Node.js

Related APIs

Land Verification for Maharashtra - Provides land record verification for Maharashtra state

Land Verification for Karnataka - Provides land record verification for Karnataka state

Property Ownership Verification - Verifies property ownership details across multiple states

Document OCR API - Extracts information from land documents for verification

Compliance and Legal Considerations

The land records provided through this API are sourced from official government records in Gujarat. While the API provides accurate information as per these records, it should not be considered a legal substitute for official land record verification through government offices. The name matching algorithm provides a confidence score but does not guarantee legal identity. Users should 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/gujarat' \ --header 'Content-Type: application/json' \ --data-raw '{ "district": "sabarkantha", "taluka": "prantij", "village": "kamalpur", "block": "14", "owner_name": "SHANUBHAI" }'

{ "data": { "client_id": "gujarat_land_verification_nxhrtWyiyXtazErKXAvU", "district": "sabarkantha", "taluka": "prantij", "village": "kamalpur", "block_code": "14", "input_owner_name": "shanubhai", "land_details": [ { "khata_number": "111", "owner_name": "Patel Jagdishbhai Keshbhai", "owner_name_gujarati": "પટેલ જગદીશભાઈ કેશાભાઈ", "name_match_score": 42 }, { "khata_number": "111", "owner_name": "Patel Keeratbhai Keshbhai", "owner_name_gujarati": "પટેલ કીરીટભાઈ કેશાભાઈ", "name_match_score": 44 }, { "khata_number": "111", "owner_name": "Patel Sureshbhai Keshbhai", "owner_name_gujarati": "પટેલ સુરેશભાઈ કેશાભાઈ", "name_match_score": 50 }, { "khata_number": "111", "owner_name": "Patel Bharatiben Keshbhai", "owner_name_gujarati": "પટેલ ભારતીબેન કેશાભાઈ", "name_match_score": 44 } ], "total_summary": { "total_area": "1-32-28", "assessment_amount": "5.40" } }, "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 ********************

Gujarat Land Verification

Gujarat Land Verification#

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

Gujarat Land Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples