Fetch All Account Validation Transactions

curl -u <YOUR_KEY>:<YOUR_SECRET> \
    -X GET https://api.razorpay.com/v1/fund_accounts/validations?account_number=7878780080316316

{
  "entity":"collection",
  "count":2,
  "items":[
    {
     "id": "fav_00000000000001",
     "entity": "fund_account.validation",
     "status": "completed",
     "validation_results": {
        "account_status": "active",
        "registered_name": "Gaurav Kumar",
        "details": "The beneficiary account is valid." ,
        "name_match_score": 100
                        },
    "status_details": {
        "description": "Validation request is completed",
        "source": "beneficiary_bank",
        "reason": "validation_completed"
                    },
    "reference_id": "112233",
    "notes": {
        "random_key_1": "Make it so.",
        "random_key_2": "Tea. Earl Grey. Hot."
            },
    "fund_account": {
        "id": "fa_00000000000001",
        "entity": "fund_account",
        "account_type": "bank_account",
        "bank_account": {
            "name": "Gaurav Kumar",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000053",
            "account_number": "765432123456789"
             },
        "active": true,
        "created_at": 1567064019,
        "contact": {
            "id": "cont_00000000000001",
            "entity": "contact",
            "name":"Gaurav Kumar",
            "email":"gaurav.kumar@example.com",
            "contact":"9123456789",
            "type":"employee",
            "reference_id":"Acme Contact ID 12345",
            "active": true,
            "created_at": 1567064019,
            "notes":{
            "notes_key_1":"Tea, Earl Grey, Hot",
            "notes_key_2":"Tea, Earl Grey... decaf."
                }
            }
        }
    },
    {
     "id": "fav_00000000000002",
     "entity": "fund_account.validation",
     "status": "completed",
     "validation_results": {
        "account_status": "active",
        "registered_name": "Gauri Kumari",
        "details": "The beneficiary account is valid." ,
        "name_match_score": 100
        },
    "status_details": {
        "description": "Validation request is completed",
        "source": "beneficiary_bank",
        "reason": "validation_completed"
        },
    "reference_id": "112244",
    "notes": {
        "random_key_1": "Make it so.",
        "random_key_2": "Tea. Earl Grey. Hot."
    },
    "fund_account": {
        "id": "fa_00000000000002",
        "entity": "fund_account",
        "account_type": "bank_account",
        "bank_account": {
            "name": "Gauri Kumari",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000054",
            "account_number": "765432123456798"
        },
        "active": true,
        "created_at": 1567064019,
        "contact": {
            "id": "cont_00000000000002",
            "entity": "contact",
            "name":"Gauri Kumari",
            "email":"gauri.kumari@example.com",
            "contact":"9999999999",
            "type":"employee",
            "reference_id":"Acme Contact ID 12354",
            "active": true,
            "created_at": 1567064120,
            "notes":{
            "notes_key_1":"Tea, Earl Grey, Hot",
            "notes_key_2":"Tea, Earl Grey... decaf."
                }
            }
        }
    }
  ]
}

GET

fund_accounts

validations?account_number=:account_number

curl -u <YOUR_KEY>:<YOUR_SECRET> \
    -X GET https://api.razorpay.com/v1/fund_accounts/validations?account_number=7878780080316316

{
  "entity":"collection",
  "count":2,
  "items":[
    {
     "id": "fav_00000000000001",
     "entity": "fund_account.validation",
     "status": "completed",
     "validation_results": {
        "account_status": "active",
        "registered_name": "Gaurav Kumar",
        "details": "The beneficiary account is valid." ,
        "name_match_score": 100
                        },
    "status_details": {
        "description": "Validation request is completed",
        "source": "beneficiary_bank",
        "reason": "validation_completed"
                    },
    "reference_id": "112233",
    "notes": {
        "random_key_1": "Make it so.",
        "random_key_2": "Tea. Earl Grey. Hot."
            },
    "fund_account": {
        "id": "fa_00000000000001",
        "entity": "fund_account",
        "account_type": "bank_account",
        "bank_account": {
            "name": "Gaurav Kumar",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000053",
            "account_number": "765432123456789"
             },
        "active": true,
        "created_at": 1567064019,
        "contact": {
            "id": "cont_00000000000001",
            "entity": "contact",
            "name":"Gaurav Kumar",
            "email":"gaurav.kumar@example.com",
            "contact":"9123456789",
            "type":"employee",
            "reference_id":"Acme Contact ID 12345",
            "active": true,
            "created_at": 1567064019,
            "notes":{
            "notes_key_1":"Tea, Earl Grey, Hot",
            "notes_key_2":"Tea, Earl Grey... decaf."
                }
            }
        }
    },
    {
     "id": "fav_00000000000002",
     "entity": "fund_account.validation",
     "status": "completed",
     "validation_results": {
        "account_status": "active",
        "registered_name": "Gauri Kumari",
        "details": "The beneficiary account is valid." ,
        "name_match_score": 100
        },
    "status_details": {
        "description": "Validation request is completed",
        "source": "beneficiary_bank",
        "reason": "validation_completed"
        },
    "reference_id": "112244",
    "notes": {
        "random_key_1": "Make it so.",
        "random_key_2": "Tea. Earl Grey. Hot."
    },
    "fund_account": {
        "id": "fa_00000000000002",
        "entity": "fund_account",
        "account_type": "bank_account",
        "bank_account": {
            "name": "Gauri Kumari",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000054",
            "account_number": "765432123456798"
        },
        "active": true,
        "created_at": 1567064019,
        "contact": {
            "id": "cont_00000000000002",
            "entity": "contact",
            "name":"Gauri Kumari",
            "email":"gauri.kumari@example.com",
            "contact":"9999999999",
            "type":"employee",
            "reference_id":"Acme Contact ID 12354",
            "active": true,
            "created_at": 1567064120,
            "notes":{
            "notes_key_1":"Tea, Earl Grey, Hot",
            "notes_key_2":"Tea, Earl Grey... decaf."
                }
            }
        }
    }
  ]
}

Available in🇮🇳 India🇲🇾 Malaysia🇸🇬 Singapore🇺🇸 United States

Use this endpoint to retrieve the details of all Fund Account Validation transactions you have made.

curl -u <YOUR_KEY>:<YOUR_SECRET> \
    -X GET https://api.razorpay.com/v1/fund_accounts/validations?account_number=7878780080316316

{
  "entity":"collection",
  "count":2,
  "items":[
    {
     "id": "fav_00000000000001",
     "entity": "fund_account.validation",
     "status": "completed",
     "validation_results": {
        "account_status": "active",
        "registered_name": "Gaurav Kumar",
        "details": "The beneficiary account is valid." ,
        "name_match_score": 100
                        },
    "status_details": {
        "description": "Validation request is completed",
        "source": "beneficiary_bank",
        "reason": "validation_completed"
                    },
    "reference_id": "112233",
    "notes": {
        "random_key_1": "Make it so.",
        "random_key_2": "Tea. Earl Grey. Hot."
            },
    "fund_account": {
        "id": "fa_00000000000001",
        "entity": "fund_account",
        "account_type": "bank_account",
        "bank_account": {
            "name": "Gaurav Kumar",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000053",
            "account_number": "765432123456789"
             },
        "active": true,
        "created_at": 1567064019,
        "contact": {
            "id": "cont_00000000000001",
            "entity": "contact",
            "name":"Gaurav Kumar",
            "email":"gaurav.kumar@example.com",
            "contact":"9123456789",
            "type":"employee",
            "reference_id":"Acme Contact ID 12345",
            "active": true,
            "created_at": 1567064019,
            "notes":{
            "notes_key_1":"Tea, Earl Grey, Hot",
            "notes_key_2":"Tea, Earl Grey... decaf."
                }
            }
        }
    },
    {
     "id": "fav_00000000000002",
     "entity": "fund_account.validation",
     "status": "completed",
     "validation_results": {
        "account_status": "active",
        "registered_name": "Gauri Kumari",
        "details": "The beneficiary account is valid." ,
        "name_match_score": 100
        },
    "status_details": {
        "description": "Validation request is completed",
        "source": "beneficiary_bank",
        "reason": "validation_completed"
        },
    "reference_id": "112244",
    "notes": {
        "random_key_1": "Make it so.",
        "random_key_2": "Tea. Earl Grey. Hot."
    },
    "fund_account": {
        "id": "fa_00000000000002",
        "entity": "fund_account",
        "account_type": "bank_account",
        "bank_account": {
            "name": "Gauri Kumari",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000054",
            "account_number": "765432123456798"
        },
        "active": true,
        "created_at": 1567064019,
        "contact": {
            "id": "cont_00000000000002",
            "entity": "contact",
            "name":"Gauri Kumari",
            "email":"gauri.kumari@example.com",
            "contact":"9999999999",
            "type":"employee",
            "reference_id":"Acme Contact ID 12354",
            "active": true,
            "created_at": 1567064120,
            "notes":{
            "notes_key_1":"Tea, Earl Grey, Hot",
            "notes_key_2":"Tea, Earl Grey... decaf."
                }
            }
        }
    }
  ]
}

Query Parameters

string

required

The account that was used to debit money for validation transaction.
Account details can be found on the RazorpayX Dashboard. For example, 7878780080316316.

Pass your Customer Identifier (RazorpayX Lite number) if money was deducted from RazorpayX Lite.
Pass your Current Account number if money was deducted from your Current Account.
This is an alphanumeric or numeric value.

Watch Out!

Log in to your RazorpayX Dashboard and go to My Account & Settings → Banking → Customer Identifier.
This value is different for Test Mode and Live Mode.

integer

Timestamp in Unix from when you want to fetch payouts.

integer

Timestamp in Unix till when you want to fetch payouts.

integer

Number of payouts to be retrieved. Default value is 10. Maximum value is 100. This can be used for pagination, in combination with skip.

integer

Number of payouts to be skipped. Default value is 0. This can be used for pagination, in combination with count.

Response Parameters

string

The unique identifier linked to the fund account. For example, fav_000000000001.

string

Here it will be fund_account.validation.

string

The status of the account validation transaction. Possible values:

created
completed
failed

string

A 12-digit unique identifier for the successful IMPS fund account validation transaction. For example, 123456789012.

object

Result of the validation.

string

Displays if the account is valid or not. Possible values:

active
invalid

string

The name linked to the account. For example,Gaurav Kumar.

string

Details of the beneficiary account depending on the validation result.

string

A score between 0 - 100.

100: The name provided by you and the bank registered name are the same.
0: There is no match between the name provided by you and the bank registered name.
Between 0 & 100: There is a partial match between the name provided by you and the bank registered name.

object

This parameter returns the current status of the customer’s bank account.

string

A description for the status. For example, Validation request is completed.

string

Possible values:

gateway: Technical error at Razorpay Partner bank.
beneficiary_bank: Technical error at beneficiary bank.
business: Merchant action required.
internal: Technical error at Razorpay’s server.

string

The reason for the status, based on the description. For example, validation_completed.

object

Fund account details to which the payout was made.

string

The unique identifier linked to the fund account. For example, fa_00000000000001.

string

Here it will be fund_account.

string

The fund account type being created. Here it will either be bank_account or vpa.

object

The contact’s bank account details.

string

Account holder’s name. For example,Gaurav Kumar.

string

The contact’s bank name. For example, HDFC.

string

Beneficiary bank IFSC. For example, HDFC0000053.

string

Beneficiary account number. For example, 765432123456789.

object

The contact’s virtual payment address (VPA) details.

string

The virtual payment address. For example, gaurav.kumar@exampleupi.

object

Contact details to which the payout was made.

string

The unique identifier linked to the contact. For example, cont_00000000000001.

string

The entity being created. Here, it will be contact.

string

The contact’s name. For example, Gaurav Kumar.

string

The contact’s email address. For example, gaurav.kumar@example.com.

string

The contact’s phone number. For example, 9000090000.

string

A classification for the contact being created. For example, employee.

string

A user-generated reference given to the payout. Maximum length is 40 characters. For example, 112233. You can use this field to store your own transaction ID, if any.

boolean

Possible values of Fund Account status:

true: active
false: inactive

integer

Timestamp, in Unix, when the fund account was created. For example, 1543650891.

object

User-entered notes for internal reference. This is a key-value pair. You can enter a maximum of 15 key-value pairs. For example, "note_key": "Beam me up Scotty".

​Query Parameters

​Response Parameters

Query Parameters

Response Parameters