> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recital.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Transfer Details

> Retrieve the status and details of a previously initiated transfer using the transfer reference.

### Query Parameters

<ParamField body="transferReference" type="string">
  The unique identifier of the transfer returned during the initiation phase.
</ParamField>

<RequestExample>
  ```bash Example Request theme={null}
  curl --location --request GET 'https://api.recital.finance/api/v1/transfer/get?transferReference=BAL-92T0DD54WVBWCHEE92NDIV2HED' \
  --header 'Authorization: Bearer apiKey'
  ```
</RequestExample>

***

### Response

<ResponseField name="message" type="string">
  Describes the result of the fetch operation.
</ResponseField>

<ResponseField name="success" type="boolean">
  Indicates whether the transfer retrieval was successful.
</ResponseField>

<ResponseField name="data" type="object">
  Contains the detailed information about the transfer (e.g., status, amount, beneficiary details, timestamps).
</ResponseField>

<ResponseExample>
  ```json Success Example theme={null}
  {
    "message": "Data retrieved successfully.",
    "success": true,
    "data": {
        "merchantID": "Sd5MCh2sdR",
        "currency": "NGN",
        "businessID": "FvhqyENCkHJAEPjfX8y6",
        "amount": 100,
        "accountTo": "0909765709",
        "connectID": "ZIrfGJRaKjaGY62",
        "callback": "http://localhost/balance/transfer/BAL-92T0DD54WVBWCHEE92NDIV2HED/callback",
        "status": "PENDING_APPROVAL",
        "transferReference": "BAL-92T0DD54WVBWCHEE92NDIV2HED",
        "narration": "test"
    }
  }
  ```
</ResponseExample>

### Notes

* This endpoint is used to poll or verify the status of a transfer after it’s been initiated or finalized.
* The `data` field contains all attributes of the transfer including processing status and any errors.

***

### Best Practices

✅ Always validate and store `transferReference` on initiation.\
✅ Use this endpoint to build status update flows for your users.\
✅ Combine with webhook events for more resilient tracking.