FMBI Verification

The Field Measurement Book Index (FMBI) OCR Service processes government-issued FMB sketch documents. It cross-verifies key land record fields from the uploaded FMBI document against the Patta data and returns structured extracted fields along with a risk score.

fmbi_verification

POST https://secctrl.tutelar.io/api/v2/kyc/utility/fmbi_verification

Header

Name	Value
Content-Type	application/json
Authorization	Bearer eyJhbGciOiJ.....

Post parameters For description is given below,

Post Parameter	Type	Is Mandatory	Description
search_type	String	Yes	Accepted value: fileUpload , manual
patta_file_url	String	Yes (Only for fileUpload)	Uploaded Patta document URL only for search type fileUpload
patta_no	String	Yes (Only for manual)	District name
village_name	String	Yes (Only for manual)	Taluk name
taluk_name	String	Yes (Only for manual)	Village name
district_name	String	Yes (Only for manual)	Patta number
subdiv_no	String	Yes (Only for manual)	Subdivision number
type	String	Yes (Only for manual)	Type values allowed: [ rural , urban ]

Sample Post Parameter - File Upload Mode

{
  "search_type": "fileUpload",
  "patta_file_url": "https://example.com/sample.pdf"
}

Sample Post Parameter - Manual Search Mode

{
  "search_type": "manual",
  "district_name": "Kanchipuram",
  "taluk_name": "Kundrathur",
  "village_name": "Padappai",
  "patta_no": "660773",
  "subdiv_no": "41014",
  "type" :"rural",
}

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "9246665c-71b8-48d3-bb6b-989cb639d1a1",
    "status": "completed",
    "result": {
        "riskScore": 8,
        "riskStatus": "LOW",
        "fileUrl": "http://3.108.106.182:8000/image-pub/kyc/TUTTEHN00417/FmbiDocuments/fmbi_verification_file_1779113932110-1779113932410.pdf",
        "district": "Kancheepuram",
        "taluk": "Kundrathur",
        "village": "Patapai(R)",
        "surveyNumber": "410/14",
        "area": "Hect 00 Ares 0 Sqm 94",
        "areaHa": 0.0094,
        "areaDisplay": "0.94 Ares",
        "scale": "1: 160mm",
        "approvedBy": "Tahsildar",
        "dateOfIssue": "18-05-2026"
    },
    "requested_at": "2026-05-18T14:17:40.481Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "c3d101d4-c9ec-48df-a25f-60354ec78c78",
    "status": "in_progress",
    "requested_at": "2026-05-18T14:17:40.481Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "searchType must be either fileUpload or manual",
    "error": {
        "message": "searchType must be either fileUpload or manual",
        "field": "search_type",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "Patta file url is required for fileUpload",
    "error": {
        "message": "Patta file url is required for fileUpload",
        "field": "patta_file_url",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "district_name is required",
    "error": {
        "message": "district_name is required",
        "field": "district_name",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "taluk_name is required",
    "error": {
        "message": "taluk_name is required",
        "field": "taluk_name",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "village_name is required",
    "error": {
        "message": "village_name is required",
        "field": "village_name",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "patta_no is required",
    "error": {
        "message": "patta_no is required",
        "field": "patta_no",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "subdiv_no is required",
    "error": {
        "message": "subdiv_no is required",
        "field": "subdiv_no",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "type is required",
    "error": {
        "message": "type is required",
        "field": "type",
        "code": "BAD_REQUEST"
    }
}
{
    "success": false,
    "code": 400,
    "message": "type must be either rural or urban",
    "error": {
        "message": "type must be either rural or urban",
        "field": "type",
        "code": "BAD_REQUEST"
    }
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "e7c76ebf-a3f5-42b5-817f-ef9fc7bf1657",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-05-18T14:17:40.481Z",
    "completed_at": "2026-05-18T14:17:40.481Z"
}

Check Document Status

Get document details

GET https://secctrl.tutelar.io/api/v2/kyc/utility/fmbi_verification

Query parameters description is given below,

Query Parameter	Type	Is Mandatory	Description
reference_id	String	Yes	Document reference id

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "9246665c-71b8-48d3-bb6b-989cb639d1a1",
    "status": "completed",
    "result": {
        "riskScore": 8,
        "riskStatus": "LOW",
        "fileUrl": "http://0.000.000.000:0000/image-pub/kyc/TUTTEHN00417/FmbiDocuments/fmbi_verification_file_1779113932110-1779113932410.pdf",
        "district": "Kancheepuram",
        "taluk": "Kundrathur",
        "village": "Patapai(R)",
        "surveyNumber": "410/14",
        "area": "Hect 00 Ares 0 Sqm 94",
        "areaHa": 0.0094,
        "areaDisplay": "0.94 Ares",
        "scale": "1: 160mm",
        "approvedBy": "Tahsildar",
        "dateOfIssue": "18-05-2026"
    },
    "requested_at": "2026-05-18T14:17:40.481Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "005d1731-85dd-4ad5-b8ff-eb67a7d2e42d",
    "status": "in_progress",
    "requested_at": "2026-05-18T14:17:40.481Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "7b2e98d5-b855-496a-8b07-c39f097dd3a9",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-05-18T14:17:40.481Z"
}