Skip to main content
GET
/
api
/
v1
/
transfer
/
get
curl --location --request GET 'https://api.recital.finance/api/v1/transfer/get?transferReference=BAL-92T0DD54WVBWCHEE92NDIV2HED' \
--header 'Authorization: Bearer apiKey'

{
  "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"
  }
}

​
Query Parameters

​
transferReference
string
The unique identifier of the transfer returned during the initiation phase.
curl --location --request GET 'https://api.recital.finance/api/v1/transfer/get?transferReference=BAL-92T0DD54WVBWCHEE92NDIV2HED' \
--header 'Authorization: Bearer apiKey'

​
Response

​
message
string
Describes the result of the fetch operation.
​
success
boolean
Indicates whether the transfer retrieval was successful.
​
data
object
Contains the detailed information about the transfer (e.g., status, amount, beneficiary details, timestamps).
{
  "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"
  }
}

​
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.
⌘I