> ## Documentation Index
> Fetch the complete documentation index at: https://cashfreepayments-d00050e9-theme-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Beneficiary V2

> Use this API to get the details of a particular beneficiary from your account. You can pass either beneficiary_id or the combination of bank_account_number and bank_ifsc to fetch the details.

<Accordion title="Click to view the response codes.">
  | HTTP Status Code | Error Code                              | Message                                                                                                                                                                            | Next Action                                                                                                                                       |
  | :--------------- | :-------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ |
  | 200              | -                                       | -                                                                                                                                                                                  | -                                                                                                                                                 |
  | 400              | too\_many\_parameters\_in\_request      | Please provide either bank\_account\_number and bank\_ifsc together or beneficiary\_id alone. Do not include all three parameters in the request                                   | Please provide either bank\_account\_number and bank\_ifsc together or beneficiary\_id alone. Do not include all three parameters in the request. |
  | 400              | bank\_ifsc\_missing                     | bank\_ifsc : should be provided with the request if bank\_account\_number is provided                                                                                              | Provide a valid bank\_ifsc if bank\_account\_number is provided.                                                                                  |
  | 400              | bank\_account\_number\_missing          | bank\_account\_number: should be provided with the request if bank\_ifsc is provided                                                                                               | Provide a valid bank\_account\_number is bank\_ifsc is provided.                                                                                  |
  | 400              | beneficiary\_identifiers\_missing       | beneficiary\_identifiers\_missing	beneficiary\_identifiers : Either beneficiary\_id or the combination of bank\_account\_number and bank\_ifsc has to be provided with the request | Please provide either beneficiary\_id or the combination of bank\_account\_number and bank\_ifsc.                                                 |
  | 400              | beneficiary\_id\_length\_exceeded       | beneficiary\_id : should not be more than 50 characters long. value received: test\_bene\_id                                                                                       | Enter a valid beneficiary\_id                                                                                                                     |
  | 400              | beneficiary\_id\_invalid                | beneficiary\_id : should contain only letters, numbers, hyphen, underscore, pipe, and dot. Value received: .\qewqefwqev                                                            | Enter a valid beneficiary\_id.                                                                                                                    |
  | 400              | bank\_account\_number\_length\_exceeded | bank\_account\_number : should not be more than 25 characters long. value received: 235142352346523462456345263452345                                                              | Provide a valid bank\_account\_number.                                                                                                            |
  | 400              | bank\_account\_number\_length\_short    | bank\_account\_number : should not be less than 4 characters long. value received: 12                                                                                              | Provide a valid bank\_account\_number.                                                                                                            |
  | .400             | bank\_account\_number\_invalid          | bank\_account\_number : should be alphanumeric. value received: 123@                                                                                                               | Provide a valid bank\_account\_number.                                                                                                            |
  | 400              | bank\_ifsc\_invalid                     | bank\_ifsc : please provide a valid IFSC. value received: SBIN00708410                                                                                                             | Provide a valid bank\_ifsc.                                                                                                                       |
  | 404              | beneficiary\_not\_found                 | Beneficiary does not exist                                                                                                                                                         | Provide the details of an existing beneficiary. If such a beneficiary does not exist, use CREATE API to create a new beneficiary.                 |
  | 404              | beneficiary\_not\_found                 | Beneficiary with the given bank\_account\_number and bank\_ifsc does not exist                                                                                                     | Provide the details of an existing beneficiary. If such a beneficiary does not exist, use CREATE API to create a new beneficiary                  |
  | 404              | beneficiary\_not\_found                 | Beneficiary exists with the given bank\_account\_number but a different bank\_ifsc                                                                                                 | If the required a beneficiary does not exist, use CREATE API to create a new beneficiary                                                          |
</Accordion>