> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Fetch All Account Validation Transactions
> Retrieve all account validations transactions via API.
Available in
🇮🇳 India
🇸🇬 Singapore
🇺🇸 United States
Use this endpoint to retrieve the details of all Fund Account Validation transactions you have made.
```bash Curl theme={null}
curl -u : \
-X GET https://api.razorpay.com/v1/fund_accounts/validations?account_number=7878780080316316
```
```json Success theme={null}
{
"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
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**](https://x.razorpay.com/auth/?intent=current_account) and go to **My Account & Settings → Banking → Customer Identifier**.
* This value is different for Test Mode and Live Mode.
Timestamp in Unix from when you want to fetch payouts.
Timestamp in Unix till when you want to fetch payouts.
Number of payouts to be retrieved. Default value is `10`. Maximum value is `100`. This can be used for pagination, in combination with `skip`.
Number of payouts to be skipped. Default value is `0`. This can be used for pagination, in combination with `count`.
## Response Parameters
The unique identifier linked to the fund account. For example, `fav_000000000001`.
Here it will be `fund_account.validation`.
The status of the account validation transaction.
Possible values:
* `created`
* `completed`
* `failed`
A 12-digit unique identifier for the successful IMPS fund account validation transaction. For example, `123456789012`.
Result of the validation.
Displays if the account is valid or not.
Possible values:
* `active`
* `invalid`
The name linked to the account. For example,`Gaurav Kumar`.
Details of the beneficiary account depending on the validation result.
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.
This parameter returns the current status of the customer's bank account.
A description for the status. For example, `Validation request is completed`.
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.
The reason for the status, based on the description. For example, `validation_completed`.
Fund account details to which the payout was made.
The unique identifier linked to the fund account. For example, `fa_00000000000001`.
Here it will be `fund_account`.
The fund account type being created. Here it will either be `bank_account` or `vpa`.
The contact's bank account details.
Account holder's name. For example,`Gaurav Kumar`.
The contact's bank name. For example, `HDFC`.
Beneficiary bank IFSC. For example, `HDFC0000053`.
Beneficiary account number. For example, `765432123456789`.
The contact's virtual payment address (VPA) details.
The virtual payment address. For example, `gaurav.kumar@exampleupi`.
Contact details to which the payout was made.
The unique identifier linked to the contact. For example, `cont_00000000000001`.
The entity being created. Here, it will be `contact`.
The contact's name. For example, `Gaurav Kumar`.
The contact's email address. For example, `gaurav.kumar@example.com`.
The contact's phone number. For example, `9000090000`.
A classification for the contact being created. For example, `employee`.
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.
Possible values of Fund Account status:
* `true`: active
* `false`: inactive
Timestamp, in Unix, when the fund account was created. For example, `1543650891`.
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"`.