> ## 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 History

> Use this API to fetch the transaction history for a particular beneficiary and for a desired period of time.

<Warning> This API will be retired soon. Please plan to migrate to the latest version, [Beneficiary V2](/api-reference/payouts/v2/beneficiary-v2/get-beneficiary-v2). </Warning>

Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)

<iframe src="https://www.cashfree.com/devstudio/preview/payouts/embed/bearerToken" width="600" />

<Accordion title="Click to view the response codes.">
  | Sub Code | Status  | Message                                           | Solution                                                 |
  | :------- | :------ | :------------------------------------------------ | :------------------------------------------------------- |
  | 200      | SUCCESS | Data retrieved successfully.                      | -                                                        |
  | 403      | ERROR   | Token is invalid.                                 | Validate the generated token.                            |
  | 405      | ERROR   | Invalid request URL or HTTP method.               |                                                          |
  | 422      | ERROR   | Requested date range is invalid.                  | Enter a valid date rage.                                 |
  | 422      | ERROR   | Page value should be minimum 1.                   | Enter the page value as 1.                               |
  | 422      | ERROR   | Please provide a valid Beneficiary Id.            | Enter a valid beneficiary ID.                            |
  | 422      | ERROR   | startDate should be of format yyyy-mm-dd          | Enter the date range in the format: yyyy-mm-dd.          |
  | 422      | ERROR   | endDate should be of format yyyy-mm-dd            | Enter the date range in the format: yyyy-mm-dd.          |
  | 422      | ERROR   | startDate should be less than or equal to EndDate | Enter a startDate value lesser than or equal to endDate. |
  | 422      | ERROR   | perPage should be at max 25                       | Enter the perPage value lesser than or equal to 25.      |
  | 429      | ERROR   | Too many requests.                                |                                                          |
  | 520      | ERROR   | Unknown error occurred.                           | Try again after some time.                               |
</Accordion>