> ## 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 Transfer Status

> Use these details to get details of a particular transfer. You can pass referenceId or transferId to fetch the details.

<Warning> This API will be retired soon. Please plan to migrate to the latest version, [Transfers V2](/api-reference/payouts/v2/transfers-v2/get-transfer-status-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 | Details of transfer with referenceId (or transferId) XXXX | -                                      |
  | 403      | ERROR   | Token is not valid                                        | Verify the generated token.            |
  | 403      | ERROR   | IP not whitelisted                                        | Whitelist the IP address.              |
  | 404      | ERROR   | TransferId is invalid or does not exist                   | Enter a valid transfer ID.             |
  | 404      | ERROR   | ReferenceId is invalid or does not exist                  | Enter a valid reference ID.            |
  | 412      | ERROR   | Token missing in the request                              | Enter a valid token in the request.    |
  | 422      | ERROR   | Please provide referenceId or transferId to fetch details | Enter a valid reference or transferId. |
  | /520     | ERROR   | Unknown error occurred                                    | Try again after some time.             |
</Accordion>

<Accordion title="Click to view failure reasons.">
  | Reason (in API response)      | Category | Description                                   | Solution                          |
  | :---------------------------- | :------- | :-------------------------------------------- | :-------------------------------- |
  | BANK\_GATEWAY\_ERROR          | Bank     | Technical error at the bank                   |                                   |
  | SOURCE\_BANK\_DECLINED        | Bank     | TPS exceeded at the bank/NPCI                 |                                   |
  | FAILED                        | Bank     | No explicit failure reason from the bank      |                                   |
  | INVALID\_AMOUNT\_FAIL         | Merchant | Amount is invalid for the given transfer mode | Enter a valid transfer amount.    |
  | INVALID\_AMOUNT\_FAIL         | Customer | Bank account is invalid                       | Enter valid bank account details. |
  | INVALID\_REQUEST              | Merchant | Request is invalid                            |                                   |
  | RETURNED\_FROM\_BENEFICIARY   | Bank     | Immediate reversal from the beneficiary bank  |                                   |
  | INSUFFICIENT\_BALANCE         | Merchant | Balance is exhausted, need to add funds       |                                   |
  | IMPS\_MODE\_FAIL              | Bank     | IMPS mode not supported for the beneficiary   |                                   |
  | RTGS\_MODE\_FAIL              | Bank     | RTGS mode not supported (only for RTGS)       |                                   |
  | REINITIALIZE\_TRANSFER\_LATER | Bank     | Technical error at the bank, retry later      |                                   |
  | NRE\_ACCOUNT\_FAIL            | Customer | Customer bank account is an NRE account       |                                   |
  | ACCOUNT\_BLOCKED              | Customer | Customer bank account is blocked              |                                   |
  | DEST\_LIMIT\_REACHED          | Bank     | Transfer limit to beneficiary exceeded        |                                   |
  | INVALID\_MODE\_FAIL           | Bank     | Transfer mode not valid for beneficiary       | Enter a different transfer mode.  |
  | NPCI\_UNAVAILABLE             | Bank     | NPCI in unavailable                           |                                   |
  | BENEFICIARY\_BANK\_OFFLINE    | Bank     | Beneficiary bank is offline                   |                                   |
</Accordion>

<Accordion title="Click to view the reversed reasons.">
  | Reason (in API response)             | Category | Description                                     | Solution                          |
  | :----------------------------------- | :------- | :---------------------------------------------- | :-------------------------------- |
  | ACCOUNT\_FROZEN\_OR\_CLOSED          | Customer | Account is closed or frozen                     |                                   |
  | CREDIT\_LIMIT\_EXCEEDED              | Customer | Transfer limit to beneficiary exceeded          |                                   |
  | ACCOUNT\_CLOSED\_OR\_FROZEN          | Customer | Transfer limit to beneficiary exceeded          |                                   |
  | ACCOUNT\_ON\_HOLD                    | Customer | Account is temporarily on hold                  |                                   |
  | ACCOUNT\_FROZEN                      | Customer | Account is frozen                               |                                   |
  | IFSC\_DOES\_NOT\_MATCH               | Customer | IFSC does not match                             | Enter a valid IFSC.               |
  | FRAUD\_REVERSED                      | Customer | Suspect fraudulent transfer                     |                                   |
  | ANY OTHER REASON                     | Bank     | Reason not specified by bank                    |                                   |
  | INVALID\_OR\_NO\_SUCH\_ACCOUNT\_TYPE | Customer | Invalid account                                 |                                   |
  | ACCOUNT\_CLOSED                      | Customer | Account is closed                               |                                   |
  | ACCOUNT\_FROZEN\_OR\_BLOCKED         | Customer | Account is frozen or blocked                    |                                   |
  | BENEFICIARY\_NAME\_DIFFERS           | Customer | Beneficiary name does not match (only for NEFT) |                                   |
  | BENEFICIARY\_BANK\_NODE\_OFFLINE     | Bank     | Beneficiary bank offline                        |                                   |
  | ACCOUNT\_DOES\_NOT\_EXIST            | Customer | Account does not exist                          | Enter valid bank account details. |
</Accordion>