District List

Endpoint Overview

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

Description

This API endpoint retrieves a comprehensive list of all districts in Karnataka state for land verification purposes. It provides standardized district names that can be used in subsequent land verification API calls. The endpoint is designed to ensure consistency in district naming conventions across the land verification workflow.

Key Benefits

Ensures accurate district selection for land verification processes

Provides up-to-date list of all 31 districts in Karnataka

Simplifies integration with other land verification APIs

Reduces errors caused by incorrect district name formatting

Use Cases

Real Estate

Banking & Finance

Government Services

Verify land records before property purchases

Validate district information for real estate listings

Streamline property documentation processes

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	JWT Bearer token. Format: `Bearer <your_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

This endpoint does not require a request body.

Process Response

Response Parameters

Parameter	Type	Description
data	array	List of district names in Karnataka
status_code	integer	HTTP status code of the response
message_code	string	Short code indicating the result of the request
message	string	Human-readable message describing the result
success	boolean	Indicates whether the request was successful

Example Successful Response

{
    "data": [
        "belgaum",
        "bagalkote",
        "bijapur",
        "gulbarga",
        "bidar",
        "raichur",
        "koppal",
        "gadag",
        "dharwad",
        "uttar kannada",
        "haveri",
        "bellary",
        "chitradurga",
        "davanagere",
        "shimoga",
        "udupi",
        "chikmagalur",
        "tumkur",
        "kolar",
        "bangalore urban",
        "bangalore rural",
        "mandya",
        "hassan",
        "dakshina kannada",
        "kodagu",
        "mysore",
        "chamarajanagara",
        "chikkaballapur",
        "ramanagara",
        "yadagir",
        "vijayanagara"
    ],
    "status_code": 200,
    "message_code": "success",
    "message": "Success",
    "success": true
}

Possible Error Responses

Authentication Error

Server Error

{
    "status_code": 401,
    "message_code": "unauthorized",
    "message": "Invalid or missing authentication token",
    "success": false
}

This error occurs when the JWT token is missing, expired, or invalid.

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 security

Implement proper error handling for authentication failures

User Experience Guidelines

Cache district list data to reduce API calls and improve performance

Implement district selection as a dropdown menu for better user experience

Use district names exactly as provided by the API in subsequent requests

Sort district names alphabetically when displaying to users

Code Samples

cURL

Python

Node.js

Related APIs

Land Record Verification API - Verifies land ownership details using district and survey information

Property Mutation API - Checks property transfer records in specified districts

Land Encumbrance API - Retrieves encumbrance certificates for properties in Karnataka districts

Compliance and Legal Considerations

The district names provided by this API are based on official government records. When using this data for land verification, ensure compliance with Karnataka Land Revenue Act and related regulations. Data should be used only for legitimate verification purposes and with appropriate user consent where required.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "data": [ "belgaum", "bagalkote", "bijapur", "gulbarga", "bidar", "raichur", "koppal", "gadag", "dharwad", "uttar kannada", "haveri", "bellary", "chitradurga", "davanagere", "shimoga", "udupi", "chikmagalur", "tumkur", "kolar", "bangalore urban", "bangalore rural", "mandya", "hassan", "dakshina kannada", "kodagu", "mysore", "chamarajanagara", "chikkaballapur", "ramanagara", "yadagir", "vijayanagara" ], "status_code": 200, "message_code": "success", "message": "Success", "success": true }

District List

District List#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

District List

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples