curl -u <YOUR_KEY>:<YOUR_SECRET> \
-X GET https://api.razorpay.com/v1/fund_accounts/validations/fav_00000000000001
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"validation_results": {
"account_status": "valid",
"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."
}
}
}
}
Composite Account Validation
Fetch Account Validation Transaction With ID
Retrieve account validations transactions with its id via API.
GET
/
v1
/
fund_accounts
/
validations
/
:id
curl -u <YOUR_KEY>:<YOUR_SECRET> \
-X GET https://api.razorpay.com/v1/fund_accounts/validations/fav_00000000000001
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"validation_results": {
"account_status": "valid",
"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."
}
}
}
}
Available in🇮🇳 India🇺🇸 United States
Use this endpoint to retrieve a particular Fund Account Validation transaction with its id.
curl -u <YOUR_KEY>:<YOUR_SECRET> \
-X GET https://api.razorpay.com/v1/fund_accounts/validations/fav_00000000000001
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"validation_results": {
"account_status": "valid",
"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."
}
}
}
}
Path Parameters
This is the unique identifier linked to the account validation transaction. For example,
fav_00000000000001.Response Parameters
A 12-digit unique identifier for the successful IMPS fund account validation transaction. For example,
123456789012.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.
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.
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.Last modified on October 8, 2026
Was this page helpful?