District List

Endpoint Overview

GET /api/v1/land-verification/madhya-pradesh/meta/district-list

Description

This API endpoint retrieves a comprehensive list of all districts in Madhya Pradesh (MP) state for land verification purposes. It provides standardized district names in a consistent format that can be used in subsequent land verification API calls. The endpoint is designed to help developers integrate land verification services for Madhya Pradesh by providing accurate and up-to-date district reference data.

Key Benefits

Provides a complete and official list of all districts in Madhya Pradesh

Returns district names in a standardized format required for other land verification APIs

Simplifies the development of location selection interfaces for land verification applications

Ensures data consistency across your land verification workflow

Use Cases

Real Estate

Financial Services

Government Services

Verify land ownership before property transactions

Build district selection dropdowns in property search applications

Validate district names in land record management systems

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 Madhya Pradesh
status_code	integer	HTTP status code of the response (200 for success)
message_code	string	Code indicating the status of the request ("success" for successful requests)
message	string	Human-readable message describing the result of the request
success	boolean	Indicates whether the API call was successful (true) or not (false)

Example Successful Response

{
    "data": [
        "agar-malwa",
        "alirajpur",
        "anuppur",
        "ashoknagar",
        "balaghat",
        "barwani",
        "betul",
        "bhind",
        "bhopal",
        "burhanpur",
        "chhatarpur",
        "chhindwara",
        "damoh",
        "datia",
        "dewas",
        "dhar",
        "dindori",
        "guna",
        "gwalior",
        "harda",
        "indore",
        "jabalpur",
        "jhabua",
        "katni",
        "khandwa east nimar",
        "khargone west nimar",
        "maihar",
        "mandla",
        "mandsaur",
        "mauganj",
        "morena",
        "narmadapuram",
        "narsimhapur",
        "neemuch",
        "niwari",
        "pandhurna",
        "panna",
        "raisen",
        "rajgarh",
        "ratlam",
        "rewa",
        "sagar",
        "satna",
        "sehore",
        "seoni",
        "shahdol",
        "shajapur",
        "sheopur",
        "shivpuri",
        "sidhi",
        "singrauli",
        "tikamgarh",
        "ujjain",
        "umaria",
        "vidisha"
    ],
    "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 your JWT token securely and never expose it in client-side code

Implement token refresh mechanisms to handle token expiration gracefully

Use HTTPS for all API communications to ensure data security

Implement proper error handling for authentication failures

User Experience Guidelines

Cache the district list to reduce API calls and improve application performance

Implement a searchable dropdown for district selection in user interfaces

Sort district names alphabetically for easier navigation

Include district selection validation to ensure only valid districts are submitted

Code Samples

cURL

Python

Node.js

Related APIs

Land Verification by Khasra Number - Retrieves land details using khasra number for a specific district

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

Land Verification Document Download - Downloads official land verification documents

Tehsil List API - Retrieves tehsils (sub-districts) for a specified district

Compliance and Legal Considerations

The district data provided by this API is sourced from official government records of Madhya Pradesh. When using this data for land verification, ensure compliance with local land record regulations and privacy laws. This API should be used as a reference for district names only and does not replace official land verification processes required by law.

{ "data": [ "agar-malwa", "alirajpur", "anuppur", "ashoknagar", "balaghat", "barwani", "betul", "bhind", "bhopal", "burhanpur", "chhatarpur", "chhindwara", "damoh", "datia", "dewas", "dhar", "dindori", "guna", "gwalior", "harda", "indore", "jabalpur", "jhabua", "katni", "khandwa east nimar", "khargone west nimar", "maihar", "mandla", "mandsaur", "mauganj", "morena", "narmadapuram", "narsimhapur", "neemuch", "niwari", "pandhurna", "panna", "raisen", "rajgarh", "ratlam", "rewa", "sagar", "satna", "sehore", "seoni", "shahdol", "shajapur", "sheopur", "shivpuri", "sidhi", "singrauli", "tikamgarh", "ujjain", "umaria", "vidisha" ], "status_code": 200, "message_code": "success", "message": "Success", "success": true }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

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