Bank Account Details Using VPA

The Bank Account Details Using VPA (Virtual Payment Address) API is a powerful tool designed to retrieve comprehensive information about bank accounts associated with a VPA. Enables users to map VPAs to corresponding bank account details, providing insights into the account holder's information, bank name, branch location, and other relevant details.

vpa_analysis

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

Post parameters description is given below,

Post Parameter	Type	Is Mandatory	Description
vpa	String	Yes	VPA Number

Sample Post Parameters

{
    "vpa": "6000000000@paytm"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "status": "completed",
    "reference_id": "391c9c44-a688-4a1f-b43f-5358f12bf775",
    "result": {
        "name": "Mr M Siva",
        "ifsc": "IDIB000T022",
        "vpa": "6000000000@paytm",
        "vpaDetails": {
            "vpa": "6000000000@paytm",
            "account_holder_name": "Mr M Siva",
            "entity_type": "INDIVIDUAL"
        },
        "accountDetails": {
            "account_type": "SAVINGS",
            "account_ifsc": "IDIB000T122"
        },
        "ifscDetails": {
            "BANK": "Indian Bank",
            "IFSC": "IDIB000T122",
            "BRANCH": "TIMIRI",
            "CENTRE": "TIMIRI",
            "DISTRICT": "TIMIRI",
            "STATE": "TAMIL NADU",
            "ADDRESS": "TIMIRI TIMIRI  PIN 632512",
            "CONTACT": "[phone]",
            "IMPS": "TRUE",
            "RTGS": "TRUE",
            "CITY": "RANIPET",
            "ISO3166": "IN-TN",
            "NEFT": "TRUE",
            "MICR": "632019040",
            "UPI": "TRUE"
        },
        "txnId": "e56f6e78-672c-465d-9a2b-3ca5aa333444"
    },
    "requested_at": "2024-03-07T06:10:46.254Z",
    "completed_at": "2024-03-07T06:10:48.565Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid vpa",
        "field": "vpa",
        "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"
}