> ## 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.
# Validate a VPA
> Validate Fund Account of type VPA via API.
Available in
🇮🇳 India
🇸🇬 Singapore
🇺🇸 United States
Use this endpoint to create a VPA (UPI) account validation transaction.
```bash Curl theme={null}
curl -u : \
-X POST https://api.razorpay.com/v1/fund_accounts/validations \
-H "Content-Type: application/json" \
-d '{
"source_account_number": "7878780080316316",
"validation_type": "pennydrop",
"reference_id": "112233",
"notes": {
"key_1": "value_1",
"key_2": "value_2"
},
"fund_account": {
"account_type": "vpa",
"vpa": {
"address": "gaurav.kumar@exampleupi"
},
"contact": {
"name": "Gaurav Kumar",
"email": "gaurav.kumar@example.com",
"contact": "9123456789",
"type": "employee",
"reference_id": "Contact_12345"
}
}
}'
```
```json Success theme={null}
{
"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,
"validated_account_type": "bank_account",
"bank_account": {
"bank_routing_code": "ICIC0000047",
"account_number": "XXXXXXXX5599",
"bank_name": "ICICI Bank",
"account_type": "savings"
}
},
"status_details": {
"description": "Validation request is completed",
"source": "beneficiary_bank",
"reason": "validation_completed"
},
"reference_id": "112233",
"fund_account": {
"id": "fa_00000000000001",
"entity": "fund_account",
"account_type": "vpa",
"vpa": {
"address": "gaurav.kumar@exampleupi"
},
"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": "Contact_12345",
"active": true
}
}
}
```
```json Failure theme={null}
{
"id": "fav_00000000000002",
"entity": "fund_account.validation",
"status": "failed",
"validation_results": {
"account_status": "",
"registered_name": "",
"details": "The beneficiary account is valid",
"name_match_score": 100,
"validated_account_type":
"bank_account": {
"bank_routing_code": null,
"account_number": null,
"bank_name": null,
"account_type": null
}
},
"fund_account": {
"id": "fa_00000000000002",
"entity": "fund_account",
"contact_id": "cont_00000000000001",
"account_type": "vpa",
"vpa": {
"username": "gaurav.kumar",
"handle": "exampleupi",
"address": "gaurav.kumar@exampleupi"
},
"batch_id": null,
"active": true,
"created_at": 1573110860
},
"amount": null,
"currency": null,
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
},
"created_at": 1574244676,
"utr": null
}
```
## Request Parameters
The account from which money should be deducted for the account validation transaction.
* Pass your customer identifier if you want money to be deducted from RazorpayX Lite.
**Watch Out!**
* This is **not** your contact's bank account number. 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.
* RazorpayX Lite is currently not available for new merchants. To set up a new RazorpayX account, refer to [Current Account](/docs/sg/x/account-types/current-account).
The method used for validating the bank account. In this case, `pennydrop`.
Maximum 40 characters. A user-entered reference for the contact. For example, `Acme Contact ID 12345`.
Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, `"note_key": "Beam me up Scotty”`.
The fund account id you want to validate.
Customer's bank account type. Possible values:
* `savings` (default)
* `current`
Target recipient's VPA address.
The details of the contact.
The customer’s name. For example, Gaurav Kumar.
The customer’s email address. For example, [gaurav.kumar@example.com](mailto:gaurav.kumar@example.com).
The customer's phone number. A maximum length of 15 characters, including country code. For example, `+919000090000`.
Defines the contact type . For example, `employee`
## Response Parameters
The unique identifier linked to the fund account validation. For example, `fav_0000000001`.
Here it is `fund_account.validation`.
The status of the account validation transaction.
Possible values:
* `created`
* `completed`
* `failed`
Details extracted from the results of the fund account validation.
Displays if the account is valid or not.
Possible values:
* `active`
* `invalid`
The name linked to the account. For example,`Gaurav Kumar` or `null`.
Brief description of the validation.
The percentage score indicating how closely the account holder's name matches the records.
Here it is `bank_account`.
The contact's bank account details.
Beneficiary bank IFSC. For example, `HDFC0000053`.
Beneficiary account number. For example, `765432123456789`.
The contact's bank name. For example, `HDFC`.
The account type being validated. For example `savings`, `current`.
Status of the fund account validation.
A brief description stating if the validation is complete or not.
The source from which validation was done. For example, `beneficiary_bank`
Reason for validation.
Unique reference\_id generated for the validation transaction.
The details of the fund account which was validated.
The unique identifier linked to the fund account. For example, `fa_00000000000001`.
Here it is `fund_account`.
Fund account type.
The details associated with the account holder's virtual payment address.
The virtual payment address of the contact whose account is validated. For example, `gaurav.kumar@exampleupi`
Possible values of fund account status:
* `true`: active
* `false`: inactive
Timestamp, in unix, when the fund account was created. For example, `1543650891`.
The contact's details.
The unique identifier linked to the contact. For example, `cont_00000000000001`.
Here it is `contact`
Account holder's name. For example,`Gaurav Kumar`.
Email address of the contact.
Phone number of the contact.
Contact Type. For example, `employee`, `contractor`.
Reference id associated with the contact.
Possible values of contact status:
* `true`: active
* `false`: inactive