Pre Verification API

The Pre Verification API lets a partner verify certain demographic information of the investor even before placing the order so that such verifications can be skipped during order processing. At present, the following investor information can be pre-verified.

Readiness of investor to invest (i.e whether the investor is KRA compliant to invest in MF)
Bank Account

Workflow to verify investor's readiness to invest

Create a Pre Verification request using the investor's PAN number as the investor_identifier. The Pre Verification will be in accepted state which means this request has been accepted and the internally the readiness check is initiated. You can use the status attribute to check the state of Pre Verification.
Check the updated status using the Fetch Pre Verification API which would take the id or Pre Verification object.
If status is completed, it means there is a result available.
At this stage, if readiness.status = verified, it means the investor is ready to invest. You can go ahead and accept the investments from such investors.
Else if readiness.status = failed, it means the investor is not yet ready to invest. Refer to readiness.code to understand why the investor is not ready.
If readiness.status = failed and readiness.code = kyc_unavailable, then it means that there is no KYC record available for this investor, at any of the KRAs. In these cases, use KYC Request feature to submit a fresh KYC application.

Workflow to verify investor's bank accounts

Create a Pre Verification request by providing pan, name and the list of bank_accounts that have to be verified. The Pre Verification will be in accepted state which means this request has been accepted and the internally the bank account verifications are attempted. You can use the status attribute to check the state of Pre Verification.
Check the updated status using the Fetch Pre Verification API which would take the id or Pre Verification object.
If status is completed, it means there is a result available.
At this stage, if bank_accounts[i].status = verified, it means that particular bank account is verified and can be used to invest. You can go ahead and accept the transactions using that bank accounts.
If bank_accounts[i].status = failed and bank_accounts[i].code = bank_verification_failed, it means that this particular bank account is not eligible to be used for transactional purposes. 5.1. In these cases, you can proceed with collecting another bank account from the investor and use that.
If bank_accounts[i].status = failed and bank_accounts[i].code = awaiting_approval_for_manual_verification_with_proof, it means that this particular bank account is eligible for manual verification and that you need to pass the bank account proof and also the consent to manually verify the bank account. 6.1. In these cases, you can go ahead and create a new Pre Verification record by providing the bank_account_proof and set verify_manually_if_required as true 6.2. In this Pre Verification result, if bank_accounts[i].status = verified, you can go ahead and accept the transactions using that particular bank account. 6.3. In this Pre Verification result, if bank_accounts[i].status = failed and bank_accounts[i].code = bank_verification_failed, it means that this particular bank account is not eligible to be used for transactional purposes.
If suppose bank_accounts[i].status = failed and bank_accounts[i].code = bank_account_proof_required, it means that you have given your consent to Pre Verification to initiate a manual verification if required; but have not provided any bank_account_proof as a supporting document. In these case, provide the bank_account_proof and create a new Pre Verification record
If suppose bank_accounts[i].status = null and bank_accounts[i].code = null, it means that the bank account verification is in progress and the results should be available soon.

Good practices to verify bank accounts using Pre Verification APIs

Always attempt the bank account verifications WITHOUT giving the bank_account_proof and the consent - verify_manually_if_required as true. This is due to the reason that manual verification of bank acccount is costly and should be attempted only if Pre Verification suggests you to do it.
Once Pre Verification lets you know that the particular bank account has to be manually verified, you can continue to provide the bank_account_proof and verify_manually_if_required flag as true in a new Pre Verification request so that the manual verification would be internally triggered.

Pre Verification Object

{
    "object": "pre_verification",
    "id": "pv_8f6ed76d90ef43a2b4854717ac78d747",
    "status": "completed",
    "investor_identifier": "GYAPS3751D",
    "readiness": {
        "status": "verified",
        "code": null,
        "reason": null
    },
    "name": {
        "status": null,
        "code": null,
        "reason": null,
        "value": "Seetharam S"
    },
    "pan": {
        "status": null,
        "code": null,
        "reason": null,
        "value": "GYAPS3751D"
    },
    "bank_accounts": [
        {
            "status": "verified",
            "code": null,
            "reason": null,
            "value": {
                "account_number": "92001091194",
                "ifsc_code": "UTIB0003093",
                "account_type": "nre_savings",
                "bank_account_proof": "file_e55ddbad95120si09153a7b1eb68fc01"
            }
        }
    ],
    "created_at": "2025-08-05T18:30:11+0530",
    "completed_at": "2025-08-05T18:34:48+0530",
    "updated_at": "2025-08-05T18:34:48+0530"
}

Pre Verification Object parameters

Attribute	Type	Remarks
object	string	Value will always be `pre_verification`. Objects of the same type share the same value
id	string	Unique identifier of the `pre_verification` object
status	string	Indicates the what status of pre verification 1. `accepted`: Pre verification request is accepted and is under progress 2. `completed`: Pre verification completed. You can refer to other attributes like `readiness` to know more about the result
investor_identifier	string	Unique identifier identifying the investor
readiness	hash	The hash representing whether the investor is ready to invest in MF
name	hash	Name of the investor
pan	hash	Pan of the investor
bank_accounts	array	Array of bank accounts
created_at	string	Preverification creation timestamp
completed_at	string	If preverification is completed, the completion timestamp.
updated_at	string	Last time when preverification was updated

Readiness hash

Attribute	Type	Remarks
status	string	1. `verified`: Investor can proceed to invest 2.`failed`:Investor cannot invest. Please check code for more details on failure
code	string	1. `kyc_unavailable`: Investor cannot invest because KYC is unavailable 2.`upstream_error`: There was an error contacting upstream to check readiness 3.`unknown`: Investor is KYC Non compliant but the reason for non-compliance is not known
reason	string	Descriptive reason for the failure. Should be only relied for understanding the failure and not for programmatically interpreting the failure. For programmatic failure interpretation always use `code`

Bank Accounts hash

Attribute	Type	Remarks
status	string	1. `verified`: Investor can proceed to invest 2.`failed`:Investor cannot invest. Please check code for more details on failure
code	string	1.`awaiting_approval_for_manual_verification_with_proof` - This bank account needs a manual verification along with an associated bank account proof along with the approval for manual verification 2. `bank_account_proof_required` This bank account needs a manual verification and in order to initiate it, the bank account proof should be provided
value.account_number	string	Bank account number
value.ifsc_code	string	IFSC code associated with the bank account
value.account_type	string	Bank account type
value.bank_account_proof	string	File ID of the bank account proof associated

Create Pre Verification API

POST /poa/pre_verifications

This API lets you create a pre verification object.

curl --location '{{base_url}}/poa/pre_verifications' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "investor_identifier": "GYAPS3751D",
    "pan": {
        "value": "GYAPS3751D"
    },
    "name": {
        "value": "Seetharam S"
    },
    "bank_accounts": [       
        {
            "value": {
                "account_number": "92001091294",
                "ifsc_code": "UTIB0003093",
                "account_type": "nre_savings",
                "bank_account_proof":  "file_e55ddbad95891ihdjh7b1eb68fc01"                
            },
            "verify_manually_if_required": true
        }
    ]
}'

Request parameters

Name	Mandatory	Type	Comments
investor_identifier	no	string	Investor identifier. Currently only PAN number of the investor is supported - Mandatory to check `Readiness of the investor to invest`
pan.value	no	hash	- Mandatory if `bank_accounts` is present with one of the `bank_account.account_type` being `savings` or `current` - Optional if `bank_accounts` is present with one of the `bank_account.account_type` as `nre_savings` or `nre_current`
name.value	no	hash	- Mandatory for bank account verification
bank_accounts	no	array	Array of `bank_account` hashes - Mandatory for bank account verification

Bank account hash

Name	Mandatory	Type	Comments
value.account_number	yes	string	Bank account number
value.ifsc_code	yes	string	IFSC code linked with the bank account
value.account_type	yes	string	Bank account type. Supported values are - `savings`, `current`, `nre_savings`, `nro_savings` Note: This is case-sensitive
value.bank_account_proof	no	string	File ID of the associated bank account proof. Use `POST /poa/files` API to upload this file. - Mandatory if you want this bank account to be manually verified in case the bank account verification demands it - Optional if you don't want this bank account to be manually verified
verify_manually_if_required	no	boolean	- If `true`, then it means you are approving the `pre_verification` object to manually verify the bank account if the need arises - If `false`, then it means you don't want `pre_verification` object to automatically verify the bank account even though there is a need of it. In these cases, you can choose to collect a different bank account from the investor and attempt verification again

The pre_verification object will be returned as the response.

Note on NRI bank account verifications

Currently, you can only attempt Pre Verification of nre_savings and nro_savings bank accounts
All the NRI bank accounts will be manually verified as of now

Note on Pre Verification object events

Events are triggered upon status changes that happen on pre_verification object.
Types of events -
- pre_verification.accepted
- pre_verification.completed
For more details, check Webhook notifications page.

Fetch Pre Verifications API

GET /poa/pre_verifications/:id

This API lets you fetch a pre verification object.

curl --location '{{base_url}}/poa/pre_verifications/:id' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'

Query parameters

Name	Mandatory	Type	Comments
id	yes	string	ID of the `pre_verification` object

The pre_verification object will be returned as the response.

Workflow to verify investor's readiness to invest​

Workflow to verify investor's bank accounts​

Good practices to verify bank accounts using Pre Verification APIs​

Pre Verification Object​

Pre Verification Object parameters​

Readiness hash​

Bank Accounts hash​

Create Pre Verification API​

Request parameters​

Bank account hash​

Note on NRI bank account verifications​

Note on Pre Verification object events​

Fetch Pre Verifications API​

Query parameters​