Feel free to reach techsupport@surepass.io for any technical support or guidance.
Block List
Production
https://kyc-api.surepass.app
Production
https://kyc-api.surepass.app
POST
https://kyc-api.surepass.app
Block List
Description
Key Benefits
Use Cases
Real Estate
Government
Financial Services
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 | JWT Bearer token for authentication (format: Bearer <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 (case-insensitive) |
| taluka | String | Yes | Name of the taluka within the specified district (case-insensitive) |
| village | String | Yes | Name of the village within the specified taluka (case-insensitive) |
Example Request
{
"district": "sabarkantha",
"taluka": "prantij",
"village": "kamalpur"
}Process Response
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| data | Object | Container for the response data |
| data.district_name | String | Name of the district provided in the request |
| data.taluka_name | String | Name of the taluka provided in the request |
| data.village_name | String | Name of the village provided in the request |
| data.block_list | Array of String | List of all block identifiers available 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_name": "sabarkantha",
"taluka_name": "prantij",
"village_name": "kamalpur",
"block_list": [
"2",
"3",
"3/p૧",
"4",
"6/p૨",
/* Additional blocks omitted for brevity */
"671",
"672"
]
},
"status_code": 200,
"success": true,
"message": "Success",
"message_code": "success"
}Possible Error Responses
Invalid Location
Authentication Error
Server Error
{
"data": null,
"status_code": 400,
"success": false,
"message": "Invalid district, taluka, 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/gujarat/meta/block-list' \
--header 'Content-Type: application/json' \
--data-raw '{
"district": "sabarkantha",
"taluka": "prantij",
"village": "kamalpur"
}'Response Response Example
{
"data": {
"district_name": "sabarkantha",
"taluka_name": "prantij",
"village_name": "kamalpur",
"block_list": [
"2",
"3",
"3/p૧",
"4",
"6/p૨",
"9/p૧",
"9/p૨",
"10/p૨",
"11/p૧",
"11/p૨",
"12/p૧",
"12/p૨",
"13",
"14",
"15",
"16",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"31",
"32",
"33",
"34/p૧",
"34/p૨",
"35",
"36/p૧",
"36/p૨",
"38",
"39",
"40",
"41",
"42",
"43",
"44",
"46",
"47",
"48",
"49",
"50",
"52",
"53",
"54",
"55",
"56",
"57",
"58",
"59",
"60",
"61",
"62",
"63",
"64",
"65",
"66",
"67",
"69",
"70",
"71",
"72",
"74",
"75",
"76",
"77",
"78",
"79",
"80",
"82",
"83",
"84",
"85",
"86",
"87",
"88",
"89",
"90",
"91",
"92",
"93",
"94",
"95",
"96",
"97",
"98",
"99/૧",
"99/૨",
"99/૩",
"99/૪",
"99/૫",
"100",
"101",
"102",
"103",
"104",
"105/૧",
"105/૨",
"106",
"107",
"108",
"109",
"110",
"111",
"112",
"113",
"114",
"116",
"117",
"119",
"120",
"121",
"122",
"123",
"124",
"125",
"126",
"127",
"129",
"130",
"131/p૧",
"131/p૨",
"132/p૧",
"132/p૨",
"133/p૧",
"133/p૨",
"134",
"135/p૧",
"135/p૨",
"136",
"137",
"138",
"139",
"140",
"141",
"142",
"144",
"145",
"146",
"147",
"148",
"149",
"150",
"151",
"153",
"155",
"156",
"157",
"158",
"159",
"160",
"161",
"162",
"163",
"164",
"165",
"166",
"167",
"168",
"169",
"170",
"171",
"172",
"173",
"174/૧",
"174/૨",
"174/૩",
"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",
"200",
"201",
"202",
"203",
"204",
"205",
"206",
"207",
"208",
"209",
"210",
"211",
"212",
"213",
"214",
"215",
"216",
"217",
"218",
"219",
"221",
"222",
"223",
"224",
"225",
"226",
"227",
"228",
"229",
"230",
"231",
"233",
"234",
"235",
"236",
"237",
"238",
"239",
"240",
"241",
"242",
"243",
"244",
"245",
"246",
"247",
"248",
"249",
"250",
"251",
"252",
"253",
"254",
"255",
"256",
"257",
"258",
"259",
"260",
"261",
"262",
"264",
"265",
"266",
"267",
"268",
"269",
"271",
"272",
"273",
"274",
"275",
"276",
"277",
"278",
"279",
"280",
"281",
"282",
"283",
"284",
"285",
"286",
"287",
"288",
"289",
"290",
"291",
"292",
"293",
"294",
"295",
"297",
"298",
"299",
"300",
"301",
"302",
"303",
"304/p૧",
"304/p૨",
"305",
"306",
"307",
"308",
"309",
"310",
"312",
"313",
"314",
"315",
"316",
"317",
"318",
"319",
"320",
"321",
"322",
"323",
"324",
"325",
"326",
"327",
"328",
"329",
"330",
"331",
"332",
"333",
"334",
"335",
"336",
"337",
"338",
"339",
"340",
"341",
"342",
"343",
"344",
"345",
"346",
"348",
"349",
"350",
"351",
"352",
"353",
"355",
"356",
"357",
"358",
"359",
"360",
"361",
"362",
"364/p૧",
"364/p૨",
"365",
"366/p૧",
"366/p૨",
"367",
"367/p૧",
"368/p૧",
"368/p૨",
"370",
"371",
"372/p૧",
"372/p૨",
"373/p૧",
"373/p૨",
"375",
"376",
"378",
"379",
"380/p૧",
"380/p૨",
"381",
"382/p૧",
"382/p૨",
"383",
"384",
"385",
"386",
"388",
"389",
"390",
"391",
"392",
"393",
"394",
"395",
"396",
"397",
"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",
"425",
"426",
"427",
"428",
"429",
"430",
"431",
"432",
"433",
"434",
"435",
"436",
"437",
"438",
"439",
"440",
"441",
"442",
"443",
"444",
"445",
"446",
"447",
"448",
"449",
"450",
"451",
"452",
"453",
"454",
"455",
"456",
"457",
"458",
"459",
"460",
"461",
"462",
"463",
"464",
"465",
"466",
"467",
"468",
"469",
"470",
"471",
"472",
"473",
"474",
"475",
"476",
"477",
"478",
"479",
"480",
"481",
"482",
"483",
"484",
"485",
"486",
"487",
"488",
"489",
"490",
"491",
"492",
"493",
"494",
"495",
"496",
"497",
"498",
"499",
"500",
"501",
"502",
"503",
"504",
"505",
"506",
"507",
"509",
"510",
"512",
"513",
"514",
"515",
"516",
"517",
"518",
"519",
"520",
"521",
"522",
"523",
"525",
"526",
"527",
"528",
"529",
"530",
"531",
"533",
"534",
"535",
"536",
"537",
"538",
"539",
"540",
"541",
"542",
"543",
"544",
"545",
"546",
"547",
"548",
"549/p૧",
"549/p૨",
"550",
"551",
"553",
"554",
"555",
"556",
"557",
"559",
"560",
"561",
"562",
"564",
"565",
"566/p૧",
"566/p૨",
"567",
"569",
"570",
"570/p૧",
"571/p૧",
"571/p૨",
"572",
"573",
"574",
"575",
"576/p૧",
"576/p૨",
"577",
"578",
"579",
"580",
"581",
"582",
"583/p૧",
"583/p૨",
"584",
"585",
"586",
"587",
"588",
"589",
"590",
"591",
"592",
"593",
"594",
"595",
"596",
"597",
"598",
"599",
"600",
"601",
"602",
"603",
"604",
"605",
"606",
"607",
"608",
"609",
"610",
"611",
"612",
"613",
"614",
"615",
"616",
"617",
"618",
"619",
"620",
"621",
"622",
"623",
"624",
"625",
"626/p૧",
"626/p૨",
"627",
"628",
"629",
"630",
"631",
"632",
"633",
"634",
"635",
"636",
"637",
"638",
"639",
"640",
"641",
"642",
"643",
"644",
"645",
"646",
"647",
"648",
"649",
"650",
"651",
"652",
"653",
"654",
"655",
"656",
"657",
"658",
"659",
"660",
"661",
"662",
"663",
"664",
"665",
"666",
"667",
"669",
"670",
"671",
"672"
]
},
"status_code": 200,
"success": true,
"message": "Success",
"message_code": "success"
}Request
Header Params
Body Params application/json