Bank Account

Data extraction of bank account refers to the process of collecting and retrieving information from a bank account.

ind_bank_account

POST https://secctrl.tutelar.io/api/v1/kyc/banking/ind_bank_account

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": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
    "status": "completed",
    "result": {
        "message": "Transaction Successful",
        "name_at_bank": "R  GOWTHAM",
        "account_number": "6147380000",
        "ifsc_code": "IDIB000T000",
        "account_exists": "YES",
        "amount_deposited": "1"
    },
    "requested_at": "2024-04-22T05:28:49.245Z",
    "completed_at": "2024-04-22T05:28:52.000Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
    "status": "in_progress",
    "requested_at": "2024-04-22T05:28:49.245Z"
}

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": "3c94fbf2-1dd0-4d8b-ac9b-d0cccfb1d02a",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-22T05:34:58.477Z",
    "completed_at": "2024-04-22T05:35:06.000Z"
}

Check Document Status

Get document details

GET https://secctrl.tutelar.io/api/v1/kyc/document/details

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": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
    "status": "completed",
    "result": {
        "message": "Transaction Successful",
        "name_at_bank": "R  GOWTHAM",
        "account_number": "6147380000",
        "ifsc_code": "IDIB088T000",
        "account_exists": "YES",
        "amount_deposited": "1"
    },
    "requested_at": "2024-04-22T05:28:49.245Z",
    "completed_at": "2024-04-22T05:28:52.000Z"
}

200: InProgress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
    "status": "in_progress",
    "requested_at": "2024-04-22T05:28:49.245Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "3c94fbf2-1dd0-4d8b-ac9b-d0cccfb1d02a",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2024-04-22T05:34:58.477Z",
    "completed_at": "2024-04-22T05:35:06.000Z"
}