Tehsil List

Endpoint Overview

POST /api/v1/land-verification/uttarakhand/meta/tehsil-list

Description

The Uttarakhand Tehsil List API returns a complete list of tehsils (sub-district administrative units) within a specified district of Uttarakhand, India. As part of the Surepass Land Verification metadata suite, this endpoint enables applications to implement cascading location selectors — where selecting a district dynamically populates the available tehsils — ensuring that all subsequent land record queries use valid, recognized administrative values.

Tehsils are a critical level of land administration in Uttarakhand; land records, ownership details, and khasra data are all organized by district and tehsil. This API ensures your application always works with accurate tehsil names in the format expected by downstream land verification endpoints.

Key Benefits

Cascading Location Support: Dynamically fetch tehsils based on a selected district, enabling seamless multi-level location pickers in your application.

Input Validation: Validate tehsil names provided by users or external data sources against the official list before submitting land record requests.

Consistent Formatting: Returns tehsil names in the exact lowercase format required by other Surepass Uttarakhand land verification APIs, preventing downstream errors.

Reduced Maintenance: Avoid maintaining hardcoded tehsil lists per district — retrieve them on demand directly from a reliable, authoritative source.

Use Cases

Real Estate

Banking & Finance

Legal & Compliance

Implement district → tehsil → village cascading dropdowns in property search or listing platforms operating in Uttarakhand.

Validate the tehsil field in property documents during title verification workflows to ensure it matches an officially recognized administrative unit.

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.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication. Format: `Bearer <JWT_TOKEN>`
Content-Type	Yes	Must be set to `application/json` since a JSON request body is required.

Request Body

Parameter	Type	Required	Description
district	string	Yes	The name of the district for which tehsils should be retrieved. Must be a valid Uttarakhand district name in lowercase (e.g., `"almora"`). Use the Uttarakhand District List API to obtain valid district values.

Example Request

{
    "district": "almora"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Contains the district name and its associated tehsil list.
data.district	string	The district name as provided in the request, echoed back in the response.
data.tehsil_list	array of strings	A list of all tehsil names within the specified district, returned in lowercase format.
status_code	integer	HTTP-equivalent status code for the response. `200` indicates success.
message_code	string	A machine-readable status indicator. `"success"` on successful responses.
message	string	A human-readable status message. `"Success"` on successful responses.
success	boolean	`true` if the request was processed successfully; `false` otherwise.

Example Successful Response

{
    "data": {
        "district": "almora",
        "tehsil_list": [
            "almora",
            "chaukhutiya",
            "jaleli",
            "jainti",
            "dwarahat",
            "bagwalipokher",
            "bhanoli",
            "bhikiyasain",
            "machhor",
            "ranikhet",
            "lamgara",
            "sult",
            "someshwar",
            "syalde"
        ]
    },
    "status_code": 200,
    "message_code": "success",
    "message": "Success",
    "success": true
}

Possible Error Responses

Unauthorized

Invalid District

{
    "data": null,
    "status_code": 401,
    "message_code": "unauthorized",
    "message": "Authentication credentials were not provided or are invalid.",
    "success": false
}

Returned when the Authorization header is missing, malformed, or contains an invalid or expired JWT token. Verify that your Bearer token is correct and that you are using the token corresponding to the intended environment (sandbox or production).

Integration Best Practices

Security Recommendations

Protect your JWT token by storing it in environment variables or a secrets manager — never embed it directly in client-side code or commit it to source control.

Use environment-specific tokens: Always pair the sandbox JWT token with the sandbox base URL (https://sandbox.surepass.app) and the production JWT token with the production base URL (https://kyc-api.surepass.app). Mixing tokens across environments will cause authentication failures.

Rotate tokens regularly and immediately revoke any token that may have been accidentally exposed.

Always communicate over HTTPS to ensure the Authorization header and request/response payloads are encrypted in transit.

User Experience Guidelines

Implement cascading selection: Trigger this API call automatically when a user selects a district, and populate the tehsil dropdown with the returned tehsil_list — this creates an intuitive, error-free location selection flow.

Cache responses per district: Since tehsil lists are relatively stable, cache the results keyed by district name (e.g., for a few hours or a day) to reduce redundant API calls and improve UI responsiveness.

Normalize input before submission: Always convert user-supplied district names to lowercase before sending them in the request body, as the API expects values in the same lowercase format returned by the District List API.

Provide clear loading feedback: Since this is a network call triggered by a user interaction (district selection), display a loading indicator in the tehsil dropdown while the response is being fetched to avoid user confusion.

Code Samples

cURL

Python

Node.js

Related APIs

Uttarakhand District List — Retrieves the complete list of districts in Uttarakhand. Use this endpoint first to obtain valid district names required as input for the Tehsil List API.

Uttarakhand Village List — Returns all villages within a specified district and tehsil, enabling the next level of the cascading location selector.

Uttarakhand Land Record Verification — The primary land verification endpoint that accepts district, tehsil, and village values to fetch and verify land ownership records.

Uttarakhand Khasra Details — Retrieves plot-level (khasra) information for a specific land parcel, identified using district, tehsil, village, and khasra number.

Compliance and Legal Considerations

This endpoint returns administrative metadata only (tehsil names) and does not expose personally identifiable information (PII) or sensitive land ownership records. However, it forms part of the broader Uttarakhand Land Verification suite, which interacts with state land revenue data governed by the Uttarakhand Revenue Code and applicable Indian land administration laws. When using the broader land verification suite, ensure your application complies with the Digital Personal Data Protection Act (DPDPA) and obtains appropriate consent from individuals whose land records are being accessed. Restrict use of the sandbox environment to development and testing only — do not submit real personal or property data to the sandbox.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/land-verification/uttarakhand/meta/tehsil-list' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "district": "almora" }'

{ "data": { "district": "almora", "tehsil_list": [ "almora", "chaukhutiya", "jaleli", "jainti", "dwarahat", "bagwalipokher", "bhanoli", "bhikiyasain", "machhor", "ranikhet", "lamgara", "sult", "someshwar", "syalde" ] }, "status_code": 200, "message_code": "success", "message": "Success", "success": true }

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