District List

Endpoint Overview

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

Description

This API endpoint retrieves a comprehensive list of all districts in Gujarat 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 and to facilitate accurate land record searches across Gujarat.

Key Benefits

Ensures consistent district naming in land verification requests

Simplifies integration with Gujarat land record systems

Reduces errors in land verification processes by providing validated district names

Enables dynamic district selection in user interfaces

Use Cases

Real Estate

Financial Services

Legal Services

Verify land ownership before property transactions

Validate district information for property listing platforms

Automate district selection in property search applications

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

Request Body

This endpoint does not require a request body as it's a GET request that returns a static list of districts.

Process Response

Response Parameters

Parameter	Type	Description
data	array	Array of strings containing district names in Gujarat
status_code	integer	HTTP status code of the response (200 for success)
message_code	string	Code indicating the result of the request ("success" for successful requests)
message	string	Human-readable message describing the result
success	boolean	Indicates whether the API call was successful (true/false)

Example Successful Response

{
    "data": [
        "ahmadabad",
        "amreli",
        "anand",
        "arvalli",
        "banaskantha",
        "bharuch",
        "bhavnagar",
        "botad",
        "chhotaudepur",
        "dahod",
        "dangs",
        "devbhumi dwarka",
        "gandhinagar",
        "gir somnath",
        "jamnagar",
        "junagadh",
        "kachchh",
        "kheda",
        "mahesana",
        "mahisagar",
        "morbi",
        "narmada",
        "navsari",
        "panchmahals",
        "patan",
        "porbandar",
        "rajkot",
        "sabarkantha",
        "surat",
        "surendranagar",
        "tapi",
        "vadodara",
        "valsad"
    ],
    "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 expired token",
    "success": false
}

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

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 responses to reduce API calls and improve performance

Implement alphabetical sorting of districts in dropdown menus for better usability

Include district selection validation to ensure only valid districts are submitted

Consider implementing type-ahead search for district selection in user interfaces

Code Samples

cURL

Python

Node.js

Related APIs

Land Verification by Survey Number - Retrieves land details using survey number and district

Land Verification by Owner Name - Searches land records by owner name in a specific district

Land Verification Document Download - Downloads official land verification documents

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 Gujarat land record regulations and data privacy laws. The information should be used only for legitimate verification purposes and with proper user consent where applicable.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

{ "data": [ "ahmadabad", "amreli", "anand", "arvalli", "banaskantha", "bharuch", "bhavnagar", "botad", "chhotaudepur", "dahod", "dangs", "devbhumi dwarka", "gandhinagar", "gir somnath", "jamnagar", "junagadh", "kachchh", "kheda", "mahesana", "mahisagar", "morbi", "narmada", "navsari", "panchmahals", "patan", "porbandar", "rajkot", "sabarkantha", "surat", "surendranagar", "tapi", "vadodara", "valsad" ], "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