Bank Verfication Pennyless

API confirms the validity and ownership details of a given bank account, ensuring accurate and secure transaction processing.

Submit Document

ind_bank_account_pennyless

POST https://secctrl.tutelar.io/api/v2/kyc/banking/ind_bank_account_pennyless

Header

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

Post parameters description is given below,

Post Parameter	Type	Is Mandatory	Description
account_number	String	Yes	Account Number
ifsc_code	String	Yes	IFSC Code

Sample Post Parameters

{
    "account_number": "6147380000",
    "ifsc_code": "IDIB088T000"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "4ac3e445-cc3c-423a-b41d-83379c2ab273",
    "status": "completed",
    "result": {
        "account_exists": true,
        "name_at_bank": "John Doe",
        "message": ""
    },
    "requested_at": "2024-03-07T10:36:31.969Z",
    "completed_at": "2024-03-07T10:36:34.060Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid ifsc code",
        "field": "ifsc_code",
        "code": "BAD_REQUEST"
    }
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "ecd78066-c7e9-4c9b-ba97-8eb18ed32947",
    "status": "failed",
    "error": {
        "message": "Validation Failed",
        "code": "ERROR"
    },
    "requested_at": "2024-03-14T05:21:05.793Z",
    "completed_at": "2024-03-14T05:21:07.640Z"
}

Check Api Status

Get account details

This Get details API using to fetch the latest updated response when the above API gave the status as in-progress by using the reference_id

GET https://secctrl.tutelar.io/api/v2/kyc/banking/ind_bank_account_pennyless

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": "4ac3e445-cc3c-423a-b41d-83379c2ab273",
    "status": "completed",
    "result": {
        "account_exists": true,
        "name_at_bank": "John Doe",
        "message": ""
    },
    "requested_at": "2024-03-07T10:36:31.969Z",
    "completed_at": "2024-03-07T10:36:34.060Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "5f674006-e943-49b7-b7b6-55040d29b870",
    "status": "in_progress",
    "requested_at": "2026-07-24T11:58:42.218Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "ecd78066-c7e9-4c9b-ba97-8eb18ed32947",
    "status": "failed",
    "error": {
        "message": "Validation Failed",
        "code": "ERROR"
    },
    "requested_at": "2024-03-14T05:21:05.793Z",
    "completed_at": "2024-03-14T05:21:07.640Z"
}