Fetch Transfer

Retrieve transfer status by reference

You are required to verify your transfer status to retrieve the session id and to confirm delivery status.

GET {{base_url}}/transfers/{{unique_reference}}

Fields with * are required

Retrieve information about the transfer.

Path Parameters

Name	Type	Description
unique_reference*	String	Your unique reference sent from the create transfer endpoint

Headers

Name		Value
Content-Type	String	application/json
Authorization*	String	Bearer {{your_secret_key}}

Response

200

{
    "success": true,
    "data": {
        "id": "ac23a67-59ba-4b30-9420-ad30035e24ca1",
        "transaction_id": "1200012584736230019316105326802",
        "reference": "testtransfer03912",
        "status": "SUCCESS",
        "narration": "Test API Transfer",
        "amount": 500000,
        "fee": 1075,
        "currency": "NGN",
        "created_at": "2024-12-08T20:58:44.000000Z",
        "updated_at": "2024-12-08T20:58:44.000000Z",
        "counterparty": {
            "account_name": "OLAJIDE AMBROSE HASSAN",
            "account_number": "81039283922",
            "nibss_code": "100015"
        }
    },
    "message": "Data retrieved successfully"
}

500

{
  "error": "Server Error"
}