Get Transfer Status

Check the status of a transfer using its UUID.

GET /v1/virtual-account/transfer/:uuid

Path Parameters

Parameter Type Required Description
uuid string Yes Transfer UUID

Example Request

curl -X GET "https://api.esca.finance/v1/virtual-account/transfer/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-Api-Key: your_api_key_here"

Example Response

{
  "status": true,
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "SUCCESS",
    "amount": 10000,
    "fee": 10.75,
    "currency": "NGN",
    "destinationAccountNumber": "0123456789",
    "destinationAccountName": "JOHN DOE",
    "destinationBankCode": "000007",
    "destinationBankName": "Fidelity Bank Plc",
    "description": "Payment for services",
    "createdAt": "2026-01-18T10:30:00.000Z",
    "updatedAt": "2026-01-18T10:30:05.000Z"
  }
}

Status Values

Status Description
PENDING Transfer is being processed
SUCCESS Transfer completed successfully
FAILED Transfer failed
REVERSED Transfer was reversed