> ## Documentation Index
> Fetch the complete documentation index at: https://doc-test-my.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a Fund Account of Type VPA
> Create a Fund Account of the type VPA via API.
Use this endpoint to create a fund account with VPA details.
* A new fund account is created if any combination of the following details is unique: `contact_id` and `vpa.address`.
* If **all** the above details match the details of an existing fund account, the API returns details of the existing fund account.
* You cannot edit the details of a fund account.
```bash Curl theme={null}
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X POST https://api.razorpay.com/v1/fund_accounts \
-H "Content-Type: application/json" \
-d '{
"account_type":"vpa",
"contact_id":"cont_00000000000001",
"vpa":{
"address":"gaurav.kumar@exampleupi"
}
}'
```
```json Success theme={null}
{
"id": "fa_00000000000002",
"entity": "fund_account",
"contact_id": "cont_00000000000001",
"account_type": "vpa",
"vpa": {
"username": "gaurav.kumar",
"handle": "exampleupi",
"address": "gaurav.kumar@exampleupi"
},
"active": true,
"batch_id": null,
"created_at": 1545223741
}
```
## Request Parameters
This is the unique identifier linked to a contact. For example, `cont_00000000000001`.
The fund account type you want to link to the contact ID. Here it is `vpa`.
The contact's virtual payment address (VPA) details.
Between 3 and 100 characters. Supported characters: `a-z`, `A-Z`, `0-9`, `.`, `-` and one `@`. The virtual payment address. For example, `gauravkumar@exampleupi`.
## 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