Taluka List

Endpoint Overview

POST /api/v1/land-verification/gujarat/meta/taluka-list

Description

This API endpoint retrieves a comprehensive list of talukas (administrative divisions) within a specified district in Gujarat state. It's designed to support land verification processes by providing accurate and up-to-date administrative boundary information. The endpoint accepts a district name as input and returns all talukas within that district, enabling applications to build dynamic, location-specific workflows for land verification services.

Key Benefits

Simplifies land verification processes by providing accurate administrative boundary data

Enables dynamic form creation with location-specific dropdown options

Reduces errors in land documentation by ensuring correct taluka selection

Supports compliance with Gujarat land registration requirements

Use Cases

Real Estate

Financial Services

Government Services

Property title verification before purchase transactions

Land boundary confirmation for development projects

Administrative location validation for property listings

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

Parameter	Type	Required	Description
district	String	Yes	Name of the district in Gujarat for which taluka list is required. Case insensitive.

Example Request

{
    "district": "sabarkantha"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.district_name	String	Name of the district that was queried
data.taluka_list	Array of Strings	List of all talukas within the specified district
status_code	Integer	HTTP status code indicating the result of the operation
success	Boolean	Indicates whether the request was successful
message	String	Human-readable description of the response status
message_code	String	Machine-readable code representing the response status

Example Successful Response

{
    "data": {
        "district_name": "sabarkantha",
        "taluka_list": [
            "khedbrahma",
            "vijaynagar",
            "vadali",
            "idar",
            "himatnagar",
            "prantij",
            "talod",
            "poshina"
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid District

Authentication Error

{
    "data": null,
    "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 in Gujarat or contains invalid characters.

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 gracefully

Use HTTPS for all API communications to ensure data privacy

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement district and taluka selection as cascading dropdowns for intuitive user experience

Cache taluka lists for frequently accessed districts to improve performance

Provide clear error messages to users when district selection is invalid

Consider implementing autocomplete for district names to reduce input errors

Code Samples

cURL

Python

Node.js

Related APIs

District List API - Retrieves all districts in Gujarat for land verification

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

Property Mutation API - Processes property ownership transfers with location validation

Compliance and Legal Considerations

The data provided by this API is for informational purposes and should be used in accordance with Gujarat land record regulations. While the API provides administrative boundary information, official land verification should always be conducted through authorized government channels. Usage of this data must comply with data protection regulations and privacy laws applicable in India.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/land-verification/gujarat/meta/taluka-list' \ --header 'Content-Type: application/json' \ --data-raw '{ "district": "sabarkantha" }'

{ "data": { "district_name": "sabarkantha", "taluka_list": [ "khedbrahma", "vijaynagar", "vadali", "idar", "himatnagar", "prantij", "talod", "poshina" ] }, "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 ********************

Taluka List

Taluka List#

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

Taluka List

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples