Feel free to reach techsupport@surepass.io for any technical support or guidance.
Khasra List
Production
https://kyc-api.surepass.app
Production
https://kyc-api.surepass.app
POST
https://kyc-api.surepass.app
Khasra List
Description
Key Benefits
Use Cases
Real Estate
Agriculture
Government
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 Different authentication tokens are used for sandbox and production environments: Sandbox: Production:
1.
2.
3.
Authorization header as Bearer TOKEN.https://sandbox.surepass.iohttps://kyc-api.surepass.ioRequest Parameters
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer token for authentication (JWT format) |
| Content-Type | Yes | Application/json |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| district | String | Yes | Name of the district in Madhya Pradesh (case-insensitive) |
| tehsil | String | Yes | Name of the tehsil within the specified district (case-insensitive) |
| village | String | Yes | Name of the village within the specified tehsil (case-insensitive) |
Example Request
{
"district": "datia",
"tehsil": "seondha",
"village": "badokhari"
}Process Response
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| data | Object | Container for the response data |
| data.district | String | Name of the district as provided in the request |
| data.tehsil | String | Name of the tehsil as provided in the request |
| data.village | String | Name of the village as provided in the request |
| data.khasra_list | Array of String | Complete list of khasra numbers in the specified village |
| status_code | Integer | HTTP status code (200 for success) |
| success | Boolean | Indicates if the request was successful |
| message | String | Human-readable status message |
| message_code | String | Machine-readable status code |
Example Successful Response
{
"data": {
"district": "datia",
"tehsil": "seondha",
"village": "badokhari",
"khasra_list": [
"324",
"1",
"2",
"3",
"4",
"5",
"6",
"7/1",
"7/2",
"7/3",
"8",
"9",
"10",
/* Additional khasra numbers omitted for brevity */
]
},
"status_code": 200,
"success": true,
"message": "Success",
"message_code": "success"
}Possible Error Responses
Invalid Location
Authentication Error
{
"status_code": 400,
"success": false,
"message": "Invalid district, tehsil, or village name provided",
"message_code": "invalid_location"
}Integration Best Practices
Security Recommendations
User Experience Guidelines
Code Samples
cURL
Python
Node.js
Related APIs
Compliance and Legal Considerations
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://kyc-api.surepass.app/api/v1/land-verification/madhya-pradesh/meta/khasra-list' \
--header 'Content-Type: application/json' \
--data-raw '{
"district": "datia",
"tehsil": "seondha",
"village": "badokhari"
}'Response Response Example
{
"data": {
"district": "datia",
"tehsil": "seondha",
"village": "badokhari",
"khasra_list": [
"324",
"1",
"2",
"3",
"4",
"5",
"6",
"7/1",
"7/2",
"7/3",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26/1",
"26/2",
"26/3",
"27",
"28/1",
"28/2/1",
"28/2/2",
"29",
"30/1",
"30/2",
"30/3",
"31",
"32",
"33",
"34/1",
"34/2",
"34/3",
"35",
"36",
"37",
"38",
"39",
"40",
"41",
"42/1",
"42/2",
"42/3",
"43",
"44",
"45",
"46",
"47/1",
"47/2",
"47/3",
"48",
"49",
"50/1",
"50/2",
"51",
"52",
"53/1",
"53/2",
"54",
"55",
"56",
"57/1",
"57/2/1",
"57/2/2",
"57/3",
"58",
"59",
"60/1",
"60/2",
"61",
"62",
"63",
"64",
"65",
"66",
"67",
"68",
"69",
"70",
"71",
"72/1",
"72/2",
"73",
"74",
"75",
"76",
"77",
"78",
"79",
"80/1",
"80/2",
"80/3",
"81",
"82",
"83",
"84",
"85",
"86",
"87",
"88",
"89",
"90",
"91",
"92",
"93",
"94/1",
"94/2",
"95",
"96",
"97",
"98",
"99",
"100",
"101",
"102",
"103",
"104",
"105",
"106/1",
"106/2",
"106/3",
"107",
"108",
"109",
"110",
"111",
"112/1",
"112/2",
"112/3",
"113",
"114/1",
"114/2",
"115",
"116",
"117",
"118",
"119",
"120",
"121",
"122",
"123",
"124",
"125/1",
"125/2",
"126",
"127",
"128/1",
"128/2",
"129",
"130",
"131",
"132",
"133",
"134/1",
"134/2",
"135",
"136",
"137",
"138",
"139",
"140",
"141",
"142/1",
"142/2",
"142/3",
"142/4",
"142/5",
"143",
"144",
"145",
"146/1",
"146/2",
"147",
"148/1",
"148/2",
"149",
"150/1",
"150/2",
"151/1",
"151/2",
"152",
"153",
"154",
"155/1",
"155/2",
"156",
"157/1",
"157/2",
"158",
"159/1",
"159/2",
"160",
"161",
"162",
"163",
"164",
"165",
"166",
"167",
"168",
"169",
"170",
"171",
"172",
"173",
"174",
"175",
"176",
"177",
"178",
"179",
"180",
"181",
"182",
"183",
"184",
"185",
"186",
"187",
"188",
"189",
"190",
"191",
"192",
"193",
"194",
"195",
"196",
"197",
"198",
"199/1",
"199/2",
"200",
"201",
"202",
"203",
"204",
"205",
"206",
"207",
"208",
"209",
"210",
"211",
"212/1",
"212/2",
"213/1",
"213/2",
"213/3",
"213/4",
"213/5",
"214",
"215",
"216",
"217/1",
"217/2",
"218",
"219",
"220",
"221/1",
"221/2",
"222",
"223/1",
"223/2",
"224",
"225",
"226",
"227",
"228",
"229",
"230",
"231",
"232",
"233",
"234",
"235/1",
"235/2",
"235/3",
"236",
"237",
"238",
"239",
"240",
"241",
"242",
"243",
"244/1",
"244/2",
"245/1",
"245/2",
"246/1",
"246/2",
"246/3",
"247/1",
"247/2",
"248/1",
"248/2",
"248/3",
"249",
"250",
"251",
"252",
"253",
"254",
"255",
"256",
"257",
"258",
"259",
"260",
"261",
"262",
"263",
"264",
"265",
"266",
"267",
"268",
"269/1",
"269/2",
"270/1",
"270/2",
"270/3",
"271",
"272",
"273",
"274",
"275",
"276",
"277",
"278",
"279/1",
"279/2",
"280",
"281",
"282",
"283",
"284",
"285",
"286",
"287",
"288",
"289",
"290",
"291/1/1",
"291/1/2",
"291/2",
"292",
"293",
"294",
"295",
"296",
"297",
"298",
"299",
"300",
"301",
"302",
"303",
"304/1",
"304/2",
"305",
"306",
"307",
"308",
"309",
"310",
"311",
"312/1",
"312/2",
"312/3",
"313",
"314",
"315",
"316",
"317/1",
"317/2",
"318",
"319/1",
"319/2",
"320",
"321",
"322",
"323",
"325",
"326",
"327",
"328",
"329",
"330",
"331",
"332",
"333",
"334",
"335",
"336",
"337",
"338",
"339",
"340",
"341",
"342",
"343",
"344",
"345",
"346",
"347",
"348",
"349/1",
"349/2",
"350",
"351",
"352",
"353",
"354",
"355",
"356",
"357",
"358",
"359",
"360",
"361",
"362",
"363",
"364",
"365",
"366",
"367",
"368",
"369",
"370",
"371",
"372",
"373",
"374",
"375",
"376",
"377",
"378",
"379",
"380",
"381",
"382",
"383",
"384",
"385",
"386",
"387",
"388",
"389",
"390",
"391",
"392/1",
"392/2",
"393",
"394",
"395/1",
"395/2",
"396/1",
"396/2/1",
"396/2/2",
"397/1",
"397/2",
"398",
"399",
"400",
"401",
"402",
"403",
"404",
"405",
"406",
"407",
"408",
"409",
"410",
"411",
"412",
"413",
"414",
"415",
"416",
"417",
"418",
"419",
"420",
"421",
"422",
"423",
"424/1",
"424/2",
"425",
"426",
"427",
"428",
"429",
"430",
"431",
"432",
"433",
"434/1",
"434/2",
"435",
"436",
"437",
"438",
"439",
"440",
"441",
"442",
"443",
"444/1",
"444/2/1",
"444/2/2",
"444/3",
"445",
"446",
"447",
"448",
"449",
"450",
"451",
"452",
"453/1",
"453/2",
"454",
"455",
"456",
"457",
"458",
"459",
"460",
"461",
"462",
"463",
"464",
"465",
"466",
"467",
"468",
"469",
"470",
"471/1",
"471/2",
"471/3",
"471/4",
"472/1",
"472/2",
"473",
"474/1",
"474/2",
"475",
"476",
"477",
"478",
"479/1",
"479/2",
"480",
"481",
"482",
"483",
"484",
"485",
"486",
"487",
"488",
"489",
"490",
"491",
"492",
"493/1",
"493/2",
"493/3",
"494",
"495",
"496",
"497",
"498/1",
"498/2",
"498/3",
"499/1",
"499/2",
"500",
"501/1",
"501/2",
"502/1",
"502/2",
"502/3",
"503",
"504",
"505",
"506",
"507/1",
"507/2",
"508",
"509",
"510",
"511",
"512",
"513",
"514/1",
"514/2",
"515",
"516",
"517/1",
"517/2",
"518",
"519/1",
"519/2",
"520",
"521",
"522",
"523",
"524",
"525",
"526",
"527",
"528",
"529/1",
"529/2",
"530/1",
"530/2",
"531",
"532",
"533",
"534",
"535/1",
"535/2",
"536",
"537",
"538",
"539",
"540",
"541",
"542",
"543",
"544",
"545",
"546",
"547",
"548",
"549/1",
"549/2",
"549/3",
"550",
"551",
"552/1",
"552/2",
"553",
"554",
"555/1",
"555/2",
"556",
"557",
"558",
"559",
"560",
"561",
"562",
"563",
"564",
"565",
"566",
"567",
"568",
"569",
"570",
"571",
"572/1",
"572/2",
"572/3",
"573",
"574",
"575",
"576",
"577",
"578",
"579",
"580",
"581",
"582",
"583",
"584",
"585",
"586",
"587",
"588",
"589",
"590",
"591",
"592",
"593",
"594",
"595",
"596",
"597",
"598",
"599",
"600",
"601/1",
"601/2",
"602",
"603/1",
"603/2",
"604",
"605",
"606",
"607",
"608",
"609",
"610",
"611",
"612/1",
"612/2",
"613",
"614",
"615",
"616",
"617",
"618",
"619",
"620/1",
"620/2",
"620/3",
"620/4",
"621",
"622",
"623",
"624",
"625",
"626/1",
"626/2",
"627",
"628",
"629",
"630",
"631",
"632",
"633",
"634",
"635",
"636",
"637",
"638",
"639",
"640",
"641",
"642",
"643",
"644",
"645/1",
"645/2",
"646",
"647",
"648/1",
"648/2",
"648/3",
"648/4",
"649",
"650",
"651",
"652",
"653",
"654",
"655",
"656",
"657",
"658",
"659",
"660",
"661",
"662",
"663",
"664",
"665",
"666",
"667",
"668",
"669",
"670",
"671",
"672",
"673",
"674",
"675",
"676",
"677",
"678",
"679",
"680",
"681",
"682",
"683",
"684",
"685",
"686",
"687",
"688",
"689",
"690/1",
"690/2",
"691/1",
"691/2",
"692",
"693",
"694",
"695/1",
"695/2",
"696",
"697",
"698/1",
"698/2",
"699/1",
"699/2",
"700",
"701",
"702",
"703",
"704",
"705",
"706/1",
"706/2",
"706/3",
"707",
"708",
"709/1",
"709/2",
"709/3",
"709/4",
"709/5",
"710",
"711",
"712",
"713",
"714",
"715",
"716",
"717",
"718",
"719",
"720",
"721",
"722",
"723",
"724/1",
"724/2",
"725/1",
"725/2",
"726/1",
"726/2",
"727/1",
"727/2",
"728",
"729",
"730",
"731",
"732",
"733",
"734",
"735",
"736",
"737/1",
"737/2",
"738/1",
"738/2",
"739",
"740",
"741/1",
"741/2",
"742",
"743",
"744/1",
"744/2",
"745",
"746",
"747",
"748",
"749",
"750",
"751",
"752",
"753",
"754",
"755",
"756",
"757",
"758",
"759",
"760",
"761",
"762",
"763/1",
"763/2",
"764",
"765",
"766/1",
"766/2",
"767",
"768/1",
"768/2",
"769",
"770",
"771",
"772",
"773",
"774",
"775",
"776/1",
"776/2",
"777",
"778",
"779",
"780",
"781",
"782",
"783",
"784",
"785",
"786",
"787/1",
"787/2",
"787/3",
"788/1",
"788/2",
"788/3",
"788/4",
"789",
"790",
"791",
"792/1",
"792/2",
"792/3",
"792/4",
"792/5",
"793",
"794",
"795",
"796",
"797",
"798",
"799/1",
"799/2",
"799/3",
"800",
"801",
"802",
"803",
"804",
"805",
"806",
"807",
"808",
"809/1",
"809/2",
"810/1",
"810/2",
"811",
"812/1",
"812/2",
"813",
"814/1",
"814/2",
"815/1",
"815/2",
"816",
"817/1",
"817/2/1",
"817/2/2",
"818",
"819/1",
"819/2",
"819/3",
"820",
"821/1",
"821/2",
"822/1",
"822/2",
"823/1",
"823/2",
"824/1",
"824/2",
"824/3",
"825/1",
"825/2",
"825/3",
"826/1",
"826/2",
"826/3",
"827",
"828/1",
"828/2",
"828/3",
"829",
"830",
"831",
"832",
"833/1",
"833/2",
"833/3",
"833/4",
"834",
"835",
"836",
"837",
"838",
"839",
"840",
"841",
"842/1",
"842/2",
"843",
"844",
"845",
"846",
"847",
"848",
"849",
"850",
"851",
"852",
"853",
"854",
"855",
"856",
"857",
"858",
"859",
"860/1",
"860/2",
"860/3",
"861/1",
"861/2",
"861/3",
"861/4",
"862/1",
"862/2",
"862/3",
"863",
"864",
"865",
"866",
"867",
"868",
"869",
"870",
"871",
"872",
"873",
"874",
"875",
"876",
"877",
"878",
"879",
"880",
"881",
"882",
"883",
"884",
"885",
"886",
"887",
"888",
"889",
"890",
"891",
"892",
"893/1",
"893/2",
"894",
"895/1",
"895/2",
"895/3",
"896",
"897",
"898",
"899/1",
"899/2",
"900",
"901",
"902",
"903",
"904",
"905",
"906",
"907/1",
"907/2",
"908/1",
"908/2",
"908/3",
"909",
"910",
"911",
"912/1",
"912/2",
"912/3",
"913/1",
"913/2",
"913/3",
"913/4",
"914",
"915/1",
"915/2",
"915/3",
"916/1",
"916/2",
"916/3",
"916/4",
"917/1",
"917/2",
"917/3",
"918/1",
"918/2",
"919/1",
"919/2",
"920/1",
"920/2",
"921/1",
"921/2",
"922",
"923",
"924",
"925",
"926",
"927",
"928",
"929",
"930",
"931",
"932",
"933",
"934",
"935",
"936",
"937",
"938",
"939/1",
"939/2",
"939/3",
"940",
"941",
"942",
"943",
"944/1",
"944/2",
"945",
"946",
"947",
"948",
"949",
"950/1",
"950/2/1",
"950/2/2",
"950/3",
"951/1",
"951/2",
"952",
"953",
"954",
"955",
"956",
"957",
"958",
"959",
"960",
"961",
"962",
"963",
"964",
"965",
"966",
"967",
"968",
"969",
"970",
"971",
"972",
"973",
"974",
"975",
"976",
"977",
"978",
"979",
"980/1",
"980/2",
"981",
"982",
"983",
"984",
"985",
"986",
"987",
"988",
"989",
"990",
"991",
"992",
"993",
"994",
"995",
"996",
"997",
"998",
"999",
"1000",
"1001",
"1002",
"1003",
"1004",
"1005",
"1006",
"1007",
"1008",
"1009",
"1010",
"1011",
"1012/1",
"1012/2",
"1013/1",
"1013/2",
"1014",
"1015",
"1016",
"1017",
"1018",
"1019",
"1020",
"1021",
"1022",
"1023",
"1024/1",
"1024/2",
"1024/3",
"1025",
"1026",
"1027",
"1028",
"1029",
"1030",
"1031",
"1032",
"1033/1",
"1033/2",
"1033/3",
"1034",
"1035",
"1036",
"1037",
"1038",
"1039",
"1040",
"1041",
"1042",
"1043",
"1044",
"1045/1",
"1045/2",
"1046",
"1047",
"1048/1",
"1048/2",
"1049",
"1050",
"1051",
"1052/1",
"1052/2",
"1053/1",
"1053/2",
"1054",
"1055/1",
"1055/2",
"1056",
"1057",
"1058/1",
"1058/3",
"1058/4",
"1058/5",
"1059",
"1060",
"1061",
"1062",
"1063",
"1064",
"1065",
"1066/1",
"1066/2",
"1067",
"1068",
"1069",
"1070",
"1071",
"1072",
"1073",
"1074",
"1075",
"1076",
"1077",
"1078",
"1079",
"1080",
"1081",
"1082",
"1083",
"1084",
"1085",
"1086",
"1087",
"1088",
"1089",
"1090",
"1091/1/1",
"1091/1/2",
"1091/2",
"1092",
"1093",
"1094",
"1095",
"1096",
"1097",
"1098",
"1099",
"1100",
"1101",
"1102",
"1103/1",
"1103/2",
"1103/3",
"1103/4",
"1104",
"1105",
"1106",
"1107",
"1108",
"1109",
"1110",
"1111/1",
"1111/2",
"1112/1",
"1112/2",
"1113/1",
"1113/2",
"1113/3",
"1113/4",
"1114",
"1115",
"1116",
"1117",
"1118",
"1119",
"1120/1",
"1120/2",
"1121",
"1122",
"1123/1",
"1123/2",
"1124",
"1125/783",
"1126/783",
"1127/507",
"1128/586"
]
},
"status_code": 200,
"success": true,
"message": "Success",
"message_code": "success"
}Request
Header Params
Body Params application/json